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

API 与集成

API 密钥

API 密钥是向 SMS API 标识账户的机密凭据,以 Bearer 令牌发送,限定可执行操作;应为每个系统分别创建,泄露时立即撤销。

API 密钥就是软件用的密码:一串较长的随机字符串,用于标识账户并携带一组权限。与个人的密码不同,它由机器使用,没有第二重验证因素,因此它的安全取决于如何签发、存储和限制。良好的实现只在创建时显示一次密钥,此后只保存其哈希值;允许你限定它能执行的操作;可以将它绑定到 IP 允许名单;并能立即撤销。可识别的前缀(例如标示正式密钥或测试密钥的前缀)有助于人工和机密扫描工具发现泄露到代码仓库或日志中的密钥。

实用的做法是:每个系统、每个环境各用一把密钥,权限只给到够用为止。密钥应放在环境变量或机密管理器中,绝不能放进客户端代码、移动应用或源代码管理系统。轮换是例行工作:创建新密钥,部署,再撤销旧密钥。发生泄露时也按同样的步骤处理,只是要立即进行。

示例

假设一家公司运行着一个只发送验证码的结账服务,以及一个只读取状态的报表任务。结账服务使用一把权限限定为发送、且只允许其两台服务器使用的正式密钥;报表任务使用只读密钥;预发布环境使用测试密钥。当报表密钥出现在一份公开日志中时,它连一条消息也发不出去,而更换它也只涉及一个系统。

常见错误

  • 把密钥随网页或应用一起分发,任何人都能从中提取。
  • 所有系统共用一把密钥,一旦泄露就得在所有地方轮换。
  • 记录完整的请求标头,从而把密钥写进日志文件。
  • 用正式密钥运行自动化测试。

在 SMSMeteor:密钥在控制面板中创建,只显示一次,以 Bearer 令牌的形式发送,前缀为 sk_live_ 或 sk_test_。密钥的权限限定为 send、read 或两者兼有,并可附带 IP 允许名单;来自其他地址的请求会收到 401 unauthorized。测试密钥会像正式密钥一样验证、计价和响应,返回状态 test,但从不发送消息,也从不计费。另请参阅安全页面。

深入了解

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