Developer

API BosNokos untuk status publik, API key v1, OTP realtime, deposit, dan webhook.

Endpoint publik bisa dipakai untuk monitoring. Endpoint v1 memakai API key bearer per user untuk bot, panel reseller, dan integrasi pribadi.

Base URL

Gunakan domain produksi untuk request publik dan callback provider.

https://bosnokos.raffzdigital.biz.id

Manifest Endpoint list

Auth model

API key dibuat dari dashboard user, token lengkap cuma tampil sekali, database hanya menyimpan hash.

Public

/api, /api/reviews, /api/health/config

Bearer API key

/api/v1/me, /api/v1/otp/orders

Provider secret

Callback pembayaran, cron, Telegram webhook

Contoh request publik

Aman dipakai untuk status page, monitoring, atau dokumentasi.

curl -s https://bosnokos.raffzdigital.biz.id/api | jq

curl -s https://bosnokos.raffzdigital.biz.id/api/health/config | jq

curl -s "https://bosnokos.raffzdigital.biz.id/api/reviews?limit=6" | jq

Contoh request API key

Generate token di dashboard /api-keys, lalu kirim sebagai Authorization Bearer.

export BOSNOKOS_API_KEY="bnk_xxx"

curl -s https://bosnokos.raffzdigital.biz.id/api/v1/me \
  -H "Authorization: Bearer $BOSNOKOS_API_KEY"

curl -s "https://bosnokos.raffzdigital.biz.id/api/v1/catalog/services?countryId=6" \
  -H "Authorization: Bearer $BOSNOKOS_API_KEY"

curl -s -X POST https://bosnokos.raffzdigital.biz.id/api/v1/otp/orders \
  -H "Authorization: Bearer $BOSNOKOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countryId":6,"operator":"any","serviceCode":"wa"}'

Buat API key

Contoh request session user

Request ini berjalan dari browser user yang sudah login. Cookie session dikirim otomatis.

await fetch("/api/deposits", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ amount: 10000, paymentMethod: "qris" })
});

await fetch("/api/otp/orders", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ countryId: 6, operator: "any", serviceCode: "wa" })
});

Rate limit rekomendasi

Angka ini jadi kontrak UI saat traffic naik.

Order OTP10 request per menit per user

Deposit create8 request per menit per user

Polling OTP15 detik otomatis, tombol manual tetap dibatasi server

Health publicCache 60 detik di monitoring

Error code

Format error route handler dibuat konsisten: { error: string }.

401UNAUTHORIZEDSession login tidak ada atau route butuh admin.

403FORBIDDENRole user tidak boleh mengakses endpoint admin.

409CONFLICTSaldo kurang, order sudah terminal, atau deposit sudah tidak pending.

422VALIDATION_ERRORInput gagal validasi Zod.

429RATE_LIMITEDTerlalu banyak request di endpoint sensitif.

500SERVER_ERRORProvider, database, atau konfigurasi server gagal.

Scope API key

Pilih akses seperlunya. Write scope bisa mengubah saldo lewat order/deposit, jadi jangan dibagi sembarang.

read:user, read:catalog, read:orders, read:deposits untuk akses data tanpa mutasi.

write:orders membuat order OTP dengan debit saldo atomik dan harga realtime provider.

write:deposits membuat deposit otomatis; saldo tetap masuk otomatis dari callback/sync tervalidasi.

Siap coba BosNokos?

Buat akun, isi saldo, lalu mulai order OTP dari dashboard yang sudah dilindungi sistem keamanan.

Daftar sekarang Masuk

export BOSNOKOS_API_KEY="bnk_xxx" curl -s https://bosnokos.raffzdigital.biz.id/api/v1/me \ -H "Authorization: Bearer $BOSNOKOS_API_KEY" curl -s "https://bosnokos.raffzdigital.biz.id/api/v1/catalog/services?countryId=6" \ -H "Authorization: Bearer $BOSNOKOS_API_KEY" curl -s -X POST https://bosnokos.raffzdigital.biz.id/api/v1/otp/orders \ -H "Authorization: Bearer $BOSNOKOS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"countryId":6,"operator":"any","serviceCode":"wa"}'

await fetch("/api/deposits", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ amount: 10000, paymentMethod: "qris" }) }); await fetch("/api/otp/orders", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ countryId: 6, operator: "any", serviceCode: "wa" }) });