• 覆盖 228 个目的地
  • 始终无需 KYC
  • 支持 Bitcoin、Monero、USDT 等 7 种币种

API 与集成

Bearer 令牌

Bearer 令牌是在 HTTP Authorization 标头中以“Bearer <token>”发送的凭据;持有者即可使用,所以只能通过 HTTPS 传输并作为机密保存。

Bearer 方案是最简单的 HTTP 身份验证形式,最初在 RFC 6750 中为 OAuth 2.0 定义,如今的使用范围早已远超于此。客户端发送 Authorization: Bearer,后面跟上令牌;服务器只检查令牌,别的一概不查:请求本身不签名,持有令牌就是唯一需要的证明。顾名思义(bearer 即“持有者”),谁持有令牌,令牌就对谁有效,就像现金一样。

这使 Bearer 身份验证既方便又通用,但也把全部安全性寄托在两个环节上:传输加密,使令牌在传输途中无法被读取;以及两端对机密的妥善处理。与对每个请求签名的方案相比,Bearer 令牌集成起来要容易得多;对于服务器之间的调用,只要令牌限定了权限、定期轮换并按 IP 加以限制,其安全性也不相上下。令牌可以是不透明的(就像大多数 API 密钥),由服务器查找核对;也可以是自包含的(就像 JSON Web Token),由服务器验证;无论哪种,标头都完全一样。

示例

假设一名开发者在调试某个集成时,把一条完整的 cURL 命令连同正式密钥一起粘贴到公开的问题跟踪系统中。现在,任何复制了它的人都能用该账户的余额发送消息。编辑帖子无济于事,因为密钥可能已经被复制;撤销它并签发新密钥才有用。

常见错误

  • 在 URL 查询字符串中传递令牌,令牌最终会出现在日志和浏览器历史记录中。
  • 通过未加密的 HTTP 发送令牌,哪怕只有一次,哪怕是在测试中。
  • 给令牌加上引号,或漏掉 Bearer 后面的空格。
  • 完整记录 Authorization 标头。

在 SMSMeteor:每个 API 请求都携带 Authorization: Bearer sk_live_…,测试时则使用 sk_test_ 密钥。密钥的权限限定为 send、read 或两者兼有,并可附带 IP 允许名单;缺失、已撤销、权限不符或受 IP 限制的密钥会得到 401 unauthorized。反方向的流量采用不同的验证方式:发送到你的 Webhook 端点的事件带有 HMAC 签名。关于密钥的更多内容,请参阅 API 密钥词条和安全页面。

深入了解

在实践中了解这个术语。一个电子邮箱地址即可开户,费率公开,支持加密货币付款,测试密钥免费。
开始发送