过去,集成短信 API 往往意味着给自己发送四十条短信,并为每一条付费。每个 SMSMeteor 账户在实时密钥旁都有一个测试密钥,前缀为 sk_test_,在任何充值之前就可以使用。
测试请求会做什么
除最后一步之外的一切。号码会被规范化为 E.164 格式,目的地得到解析,发件人规则得到应用,文本完成编码和分段,并按实时费率表计算价格。响应与真实响应相同,只是带有 "status": "test"。消息不会交给运营商,也不会扣除余额。
由于验证是真实的,测试密钥能在集成阶段发现关键错误:缺少国家代码的号码、不在路由范围内的目的地、比你预想更长的文本,以及在某些路由上会被替换的发件人。segments 和 price 字段会告诉你真实发送的费用。
Webhook 也一样
测试消息会向你的端点发出 Webhook,签名方式与真实消息完全一致。你可以端到端地构建并验证处理程序:签名校验、去重,以及数据库中的状态更新。快速入门会用五分钟带你走完整个流程。
它无法告诉你什么
测试密钥无法告诉你真实消息是否会送达、送达有多快,或在手机上会以哪个发件人显示;只有运营商才能回答这些问题。由于不会扣费,它也无法检验你的余额逻辑。
正式上线
- 创建一个权限范围尽可能小的实时密钥:负责发送的服务用
send,仪表板用read。 - 尽可能将密钥限制为仅供你服务器的 IP 地址使用;来自其他地址的请求会被拒绝。
- 用一笔小额充值为余额注资。
- 向自己的手机发送一条真实消息,并检查三件事:是否到达、显示的发件人,以及数据库中的
message.deliveredWebhook。 - 将生产环境配置切换为实时密钥。
密钥使用规范
- 每个环境、每个服务分别使用不同的密钥,这样撤销其中一个不会让所有服务停摆。
- 将密钥保存在环境变量或密钥管理服务中,绝不要放在前端代码或代码仓库里。
- 如果密钥出现在日志、工单或截图中,请立即轮换。
- 无论测试还是真实发送,每次发送都使用 Idempotency-Key,这样重试绝不会造成重复发送。
使用本文介绍的产品开始发送。一个电子邮箱地址即可开户。费率公开,支持加密货币付款。
开始发送


