Pagpapatunay gamit ang API keys

Ang bawat endpoint maliban sa dalawang pricing endpoints ay nangangailangan ng API key sa Authorization header.

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

Paggawa ng mga key

• Ang mga key ay ginagawa sa API keys page ng console. Ang page ay magbubukas pagkatapos maidagdag ang unang top-up sa balance.
• Ang isang account ay maaaring magkaroon ng 10 active keys. Bigyan ang bawat app o environment ng sarili nitong key at pangalan, upang ang isa ay mapalitan nang hindi naaapektuhan ang iba.
• Ang isang key ay bsa_live_ na sinusundan ng 32 letra at digit. Ito ay ipapakita minsan, kapag ito ay ginawa; nag-iimbak lamang kami ng keyed hash, kaya ang nawalang key ay hindi na maipakita muli. Gumawa na lang ng bago.
• Ang listahan ay nagpapakita ng mga unang character, ang huling apat, kung kailan ginawa ang key at kung kailan ito huling ginamit.

Pag-rotate at pag-revoke

Para i-rotate ang isang key nang walang downtime: gumawa ng pangalawang key, i-deploy ito, suriin ang huling ginamit na oras sa console, pagkatapos ay i-revoke ang lumang key. Ang isang revoked key ay magsasagot ng 401 unauthorized mula sa susunod na request.

Pag-iingat ng mga key

• Tumawag sa API mula sa iyong server, huwag kailanman mula sa browser o mobile app: sinumang may key ay maaaring magpadala ng mensahe mula sa iyong balance.
• Panatilihin ang mga key sa environment variables o secret manager, hindi sa source control.
• Ang bawat key ay may sariling rate limit counter, kaya ang isang busy worker ay hindi magpapabagal sa pangalawang key na ginagamit sa ibang lugar.

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