Pengesahan dengan kunci API

Setiap endpoint kecuali dua endpoint harga memerlukan kunci API dalam header Authorization.

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

Mencipta kunci

• Kunci dicipta pada halaman kunci API konsol. Halaman dibuka selepas top-up pertama ditambah ke baki.
• Satu akaun boleh memegang 10 kunci aktif. Beri setiap apl atau persekitaran kunci dan nama sendiri, supaya satu boleh diganti tanpa menyentuh yang lain.
• Kunci ialah bsa_live_ diikuti 32 huruf dan digit. Ia ditunjukkan sekali, semasa dicipta; kami hanya menyimpan hash berkunci, jadi kunci yang hilang tidak boleh ditunjukkan lagi. Sebaliknya, buat yang baru.
• Senarai menunjukkan aksara pertama, empat terakhir, bila kunci dicipta dan bila kali terakhir digunakan.

Memutar dan membatalkan

Untuk memutar kunci tanpa downtime: buat kunci kedua, laksanakannya, semak masa terakhir digunakan dalam konsol, kemudian batalkan kunci lama. Kunci yang dibatalkan menjawab 401 unauthorized dari permintaan seterusnya.

Menjaga keselamatan kunci

• Panggil API dari pelayan anda, jangan dari pelayar atau apl mudah alih: sesiapa dengan kunci boleh menghantar mesej dari baki anda.
• Simpan kunci dalam pembolehubah persekitaran atau pengurus rahsia, bukan dalam kawalan sumber.
• Setiap kunci mempunyai kaunter had kadar sendiri, jadi pekerja yang sibuk tidak memperlahankan kunci kedua yang digunakan di tempat lain.

Ralat

{
  "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"
  }
}