開始使用

使用 API 密鑰進行身份驗證

除兩個定價端點外，每個端點都需要在 Authorization 標頭中包含 API 密鑰。

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

創建密鑰

密鑰在控制台的 API 密鑰頁面創建。該頁面在首次充值後打開。
一個帳戶可持有 10 個有效密鑰。為每個應用或環境分配專屬密鑰和名稱，以便替換時不影響其他密鑰。
密鑰以 bsa_live_ 開頭，後接 32 個字母和數字。創建時只顯示一次；我們只保存密鑰的哈希值，因此丟失的密鑰無法再次顯示。請創建新密鑰代替。
列表顯示密鑰的前幾個字符、最後四位、創建時間和最後使用時間。

輪換和撤銷

無停機輪換密鑰：創建第二個密鑰，部署後在控制台檢查其最後使用時間，然後撤銷舊密鑰。撤銷的密鑰從下一次請求開始回應 401 unauthorized。

保護密鑰安全

從你的伺服器呼叫 API，切勿從瀏覽器或移動應用呼叫：任何擁有密鑰的人都可以從你的餘額發送訊息。
將密鑰保存在環境變量或密鑰管理器中，而非源代碼控制中。
每個密鑰都有獨立的速率限制計數器，因此繁忙的進程不會影響其他密鑰的使用。

錯誤

401 UnauthorizedJSON

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