Developer API v1

Dokumentasi API

Beli nomor OTP, cek kode, dan isi saldo dari aplikasimu sendiri. Semua respon berformat JSON.

RESTJSON
60/mntrate limit
Bearerautentikasi
BASE URL
/api/v1
AUTENTIKASI

Kirim API key di header, atau lewat ?api_key=KEY. Key ada di Dashboard › Lainnya › API Key.

Authorization: Bearer API_KEY
MULAI CEPAT
curl /api/v1/me \
  -H "Authorization: Bearer API_KEY"
ALUR PEMBELIAN
1Cek hargaGET /countries
2Buat orderPOST /order
3Tunggu OTPGET /orders/status
4Selesai / batalrefund otomatis

👤Akun

GET/meInfo akun, saldo, dan API key.
URL
GET /api/v1/me
CONTOH RESPON
{ "name": "Budi", "balance": 48500, "apikey": "..." }

📱Layanan & harga

GET/serversDaftar server yang aktif.
URL
GET /api/v1/servers
CONTOH RESPON
{ "items": [{ "server": "warungnokos_s1", "name": "Server Plus" }] }
GET/services?server=Daftar aplikasi/layanan OTP.
PARAMETER
serverwarungnokos_s1 atau warungnokos_s2
URL
GET /api/v1/services?server=
CONTOH RESPON
{ "items": [{ "service_code": "wa", "service_name": "WhatsApp" }] }
GET/countries?server=&service_id=Negara, stok, dan harga jual (sell_price).
PARAMETER
serverserver pilihan
service_idkode layanan
URL
GET /api/v1/countries?server=&service_id=
CONTOH RESPON
{ "items": [{ "name": "Indonesia", "pricelist": [{ "provider_id": 1, "sell_price": 3500, "stock": 120 }] }] }

🛒Order nomor

POST/orderBuat order nomor. Saldo langsung terpotong.
PARAMETER
serverserver
serviceIdkode layanan
countryIdid negara
providerIdid penyedia
operatorIdopsional
guaranteetrue = Jaminan OTP (+10%)
URL
POST /api/v1/order
CONTOH RESPON
{ "orderId": "123", "phoneNumber": "628123...", "price": 3500, "expiredAt": 1760000000000 }
GET/ordersDaftar order (limit, page).
PARAMETER
limitmaks 100
pagenomor halaman
URL
GET /api/v1/orders
CONTOH RESPON
{ "items": [{ "orderId": "123", "status": "pending" }] }
GET/orders/status?order_id=Cek status dan kode OTP.
PARAMETER
order_idid order
URL
GET /api/v1/orders/status?order_id=
CONTOH RESPON
{ "status": "success", "otpCode": "482913" }
POST/orders/cancelBatalkan order (bisa setelah 3 menit, saldo refund).
PARAMETER
order_idid order
URL
POST /api/v1/orders/cancel
CONTOH RESPON
{ "status": "cancelled", "refunded": true }

💳Deposit

GET/deposit/methodsMetode deposit yang tersedia.
URL
GET /api/v1/deposit/methods
CONTOH RESPON
{ "methods": [{ "provider": "qris" }] }
POST/depositBuat QRIS. Nominal Rp2.000 - Rp10.000.000. Bonus deposit masuk otomatis.
PARAMETER
amountnominal
providerdari /deposit/methods
URL
POST /api/v1/deposit
CONTOH RESPON
{ "order_id": "D1", "total_amount": 10120, "qr_image": "..." }
GET/deposit?order_id=Status deposit (tanpa order_id = 20 deposit terakhir).
PARAMETER
order_idid deposit
URL
GET /api/v1/deposit?order_id=
CONTOH RESPON
{ "status": "completed", "credited": true, "balance": 58500 }
POST/deposit/cancelBatalkan deposit yang belum dibayar.
PARAMETER
order_idid deposit
URL
POST /api/v1/deposit/cancel
CONTOH RESPON
{ "ok": 1, "status": "canceled" }

🌍Publik (tanpa API key)

GET/announcementsPengumuman dari admin.
URL
GET /api/v1/announcements
CONTOH RESPON
{ "items": [{ "title": "...", "body": "..." }] }
GET/leaderboardLeaderboard saldo, transaksi, mingguan, dan bulanan (email disensor).
URL
GET /api/v1/leaderboard
CONTOH RESPON
{ "bal": [], "trx": [], "wk": [], "mo": [] }
GET/promoInfo bonus deposit, referral, dan hadiah leaderboard.
URL
GET /api/v1/promo
CONTOH RESPON
{ "bonus": { "pct": 2 }, "ref": {}, "weekly": {} }
KODE ERROR
401API key tidak valid atau belum login
403Akun ditangguhkan
400Parameter salah / saldo tidak cukup
404Data tidak ditemukan
429Terlalu banyak request, lihat header Retry-After
502Penyedia nomor menolak / gangguan
💬