API Documentation.
Integrasikan layanan YouzOTP ke sistem Anda menggunakan REST API.
Base URL:
https://youzotp.my.id/api/v1
Autentikasi
Sertakan header berikut di setiap request:
Authorization: Bearer YOUR_API_KEY
X-API-ID: YOUR_API_ID
Accept: application/json
Content-Type: application/json
Dapatkan API Key dan API ID di halaman Profile → Developer API. IP Whitelist wajib diatur sebelum request produk YouzOTP.
NOKOS OTP
GET
/nokos/services
Daftar layanan tersedia
{ items: [{ service_code, name }] }
GET
/nokos/countries?service_code=wa
Negara untuk layanan
{ items: [{ country_id, name, stock, min_price }] }
GET
/nokos/operators?service_code=wa&country_id=6
Operator/server tersedia
{ items: [{ operator_id, operator_name, price, stock }] }
POST
/nokos/order
Buat order nomor virtual
Body:
{ service_code, country_id, operator_id? }{ order: { order_id, number, status } }
GET
/nokos/status/:order_id
Status & OTP order
{ order: { status, otp_code, number } }
POST
/nokos/cancel
Batalkan order aktif
Body:
{ order_id }{ refunded: true/false }
Deposit
POST
/deposit
Buat invoice deposit QRIS
Body:
{ amount }{ deposit: { invoice_id, qr_image_url, status } }
GET
/deposit/status/:invoice_id
Cek status pembayaran
{ deposit: { status, amount } }
GET
/deposit
Riwayat deposit
{ items: [...], meta: { total, page } }
Akun
GET
/profile
Info akun & saldo
{ id, username, email, balance, status }
Rate Limit & IP Whitelist
Pastikan IP server Anda sudah ditambahkan ke whitelist di halaman Profile. Request dari IP yang tidak terdaftar akan ditolak dengan status 403.