使用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，切勿从浏览器或移动应用调用：任何拥有密钥的人都可以从您的余额中发送消息。
• 将密钥保存在环境变量或密钥管理器中，而不是源代码控制中。
• 每个密钥都有自己的速率限制计数器，因此繁忙的工作线程不会减慢其他地方使用的第二个密钥。

错误代码

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