Dokumentasi API

Getting Started

Panduan cepat untuk menghubungkan aplikasi Anda ke NEXOTP API dan membuat order nomor virtual pertama.

1. Generate API key

Buka dashboard API Keys, buat key baru, lalu simpan token di backend aplikasi Anda.

2. Read catalogue

Ambil daftar services, countries, dan providers untuk menampilkan pilihan order ke user.

3. Create order

Kirim service, country, provider, dan idempotencyKey ke endpoint order.

4. Poll order status

Ambil status order tiap 3–5 detik sampai OTP diterima, expired, atau cancelled.

Quick test

Mulai dari endpoint services untuk memastikan API key, base URL, dan response format sudah benar.

Example
curl -X GET "https://webnokosai.vercel.app/api/v1/services" \
  -H "Authorization: Bearer nx_live_xxx"

Create your first order

Gunakan idempotencyKey unik dari sistem Anda untuk mencegah order ganda ketika request di-retry.

Example
curl -X POST "https://webnokosai.vercel.app/api/v1/order" \
  -H "Authorization: Bearer nx_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"id","provider":"any","idempotencyKey":"order-1001"}'