测试密钥是一种 API 凭据,与实时密钥一样接受、验证和计价请求,却从不发送消息或扣除余额,使集成可在充值前完成。
测试密钥为集成提供了一个可以放心出错的地方。用它发出的请求会经过与正式流量相同的验证和计价,得到结构相同的响应,因此请求格式、错误处理、重试和 Webhook 处理都可以在不产生任何后果的情况下得到检验。最好的沙盒与生产环境只有一处不同,那就是实际发送;而且它会用专门的状态明确标出这一差异,而不是假装消息已经送达。
测试密钥证明的是集成,而不是路由。消息能否到达手机、到得多快、以哪个发件人显示、文本在手机上如何呈现,只有正式流量才能显示出来。通常的顺序是:开发和自动化测试使用测试密钥,然后向你自己的手机发送几条正式消息,最后进入生产。把测试密钥和正式密钥放在不同的环境中,并在代码中根据状态分支处理,可以防止测试结果混入真实记录。
这也是免费试用的诚实形式:不赠送任何东西,也不伪造任何结果。
示例
假设一名开发者在预发布服务器上用测试密钥搭建注册验证码流程。每个请求都返回消息 ID、价格和分段数,状态为 test;无效号码会以与正式流量相同的错误失败;签名 Webhook 会到达她的预发布端点,因此签名检查也一并得到测试。上线只需更改一个配置值。
常见错误
- 在自己的数据库中把测试消息记录为已送达。
- 在自动化测试中使用正式密钥。
- 把一次顺利的测试运行当作能够送达某个国家的证明。
在 SMSMeteor:每个账户都有一把 sk_test_ 密钥。用它发出的请求会经过验证和计价,并以状态 test 作出响应;不会发送任何消息,也不会产生任何费用,但 Webhook 仍会触发,并像正式事件一样签名。控制面板还可以向你的端点发送任意类型的测试事件。无需花费即可集成一文详细介绍了这种做法;另请参阅快速入门。
相关术语
深入了解
在实践中了解这个术语。一个电子邮箱地址即可开户,费率公开,支持加密货币付款,测试密钥免费。
开始发送
