Xác thực bằng API keys

Mọi endpoint ngoại trừ hai endpoint định giá đều cần một API key trong tiêu đề Authorization.

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

Tạo khóa

• Các khóa được tạo trên trang API keys của console. Trang này mở ra sau khi lần nạp tiền đầu tiên được thêm vào số dư.
• Một tài khoản có thể giữ 10 khóa hoạt động. Cung cấp cho mỗi ứng dụng hoặc môi trường một khóa và tên riêng, để một khóa có thể được thay thế mà không ảnh hưởng đến các khóa khác.
• Một khóa là bsa_live_ theo sau bởi 32 chữ cái và chữ số. Nó chỉ hiển thị một lần khi được tạo; chúng tôi chỉ giữ một hash được mã hóa, vì vậy một khóa bị mất không thể hiển thị lại. Thay vào đó, hãy tạo một khóa mới.
• Danh sách hiển thị các ký tự đầu tiên, bốn ký tự cuối cùng, thời điểm khóa được tạo và lần cuối cùng được sử dụng.

Xoay vòng và thu hồi

Để xoay vòng một khóa mà không gây gián đoạn: tạo một khóa thứ hai, triển khai nó, kiểm tra thời gian sử dụng cuối cùng trong console, sau đó thu hồi khóa cũ. Một khóa bị thu hồi sẽ trả lời 401 unauthorized từ yêu cầu tiếp theo.

Giữ khóa an toàn

• Gọi API từ máy chủ của bạn, không bao giờ từ trình duyệt hoặc ứng dụng di động: bất kỳ ai có khóa đều có thể gửi tin nhắn từ số dư của bạn.
• Giữ các khóa trong biến môi trường hoặc trình quản lý bí mật, không phải trong kiểm soát mã nguồn.
• Mỗi khóa có bộ đếm giới hạn tốc độ riêng, vì vậy một worker bận rộn sẽ không làm chậm một khóa thứ hai được sử dụng ở nơi khác.

Lỗi

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