Autentikasi dengan kunci API

Setiap endpoint kecuali dua endpoint pricing memerlukan kunci API di header Authorization.

POST /v1/messages HTTP/1.1
Host: bulksmsapi.cc
Authorization: Bearer bsa_live_7QzX2mW9kR4tB8nV1cJ6yP3sH5dL0aFe
Content-Type: application/json

Membuat kunci

• Kunci dibuat di halaman kunci API pada konsol. Halaman tersebut terbuka setelah top-up pertama ditambahkan ke saldo.
• Sebuah akun dapat menyimpan 10 kunci aktif. Berikan setiap aplikasi atau lingkungan kunci dan nama sendiri, sehingga satu kunci dapat diganti tanpa mengganggu yang lain.
• Sebuah kunci adalah bsa_live_ diikuti oleh 32 huruf dan angka. Kunci hanya ditampilkan sekali saat dibuat; kami hanya menyimpan hash yang diberi kunci, sehingga kunci yang hilang tidak dapat ditampilkan lagi. Sebagai gantinya, buat yang baru.
• Daftar menunjukkan karakter pertama, empat terakhir, kapan kunci dibuat, dan kapan terakhir digunakan.

Memutar dan mencabut

Untuk memutar kunci tanpa downtime: buat kunci kedua, terapkan, periksa waktu terakhir digunakan di konsol, lalu cabut kunci lama. Kunci yang dicabut akan menjawab 401 unauthorized dari permintaan berikutnya.

Menjaga kunci tetap aman

• Panggil API dari server Anda, jangan pernah dari browser atau aplikasi seluler: siapa pun yang memiliki kunci dapat mengirim pesan dari saldo Anda.
• Simpan kunci dalam variabel lingkungan atau manajer rahasia, bukan dalam kontrol sumber.
• Setiap kunci memiliki penghitung batas kecepatan sendiri, sehingga pekerja yang sibuk tidak memperlambat kunci kedua yang digunakan di tempat lain.

Error

{
  "error": {
    "code": "unauthorized",
    "message": "Send your API key as Authorization: Bearer bsa_live_... Keys are created in the console under API keys.",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#unauthorized"
  }
}