Public API v1

Public API SpeedOTP memungkinkan kamu mengintegrasikan akunmu langsung dari aplikasi, bot, atau website milikmu sendiri. Saat ini tersedia endpoint cek saldo; endpoint lain akan ditambahkan seiring penambahan produk.

Semua response menggunakan format JSON yang konsisten:

{
  "success": true,
  "data": { ... },
  "message": null
}

Setiap request wajib menyertakan header X-API-Key. Dapatkan API key kamu di halaman Profil → Developer Tools.

curl https://speedone.web.id/api/v1/balance \
  -H "X-API-Key: sotp_xxxxxxxxxxxxxxxxxxxx"

Setiap endpoint memiliki batas jumlah request untuk menjaga stabilitas layanan:

Melebihi limit akan mendapat response HTTP 429 dengan header Retry-After.

Mengambil saldo akun kamu saat ini.

curl https://speedone.web.id/api/v1/balance \
  -H "X-API-Key: sotp_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "data": { "balance": 25000 },
  "message": null
}

Kalau request gagal, success akan bernilai false dan message berisi keterangan error. Berikut contoh response error:

{
  "success": false,
  "data": null,
  "message": "API key tidak valid."
}