如果您希望体验短信发送或您的应用还未上线,可以通过短信服务的快速学习与测试,使用控制台或调用API接口,快速发送测试短信。
使用须知
准备工作
发送测试前您需提交短信资质、签名和模板申请,并等待审核通过及签名实名制报备完成。
操作步骤
API发送测试
|
|
|
常见 API 参数错误排查
发起 API 调用后如遇发送失败,请逐项核查以下参数:
参数 | 常见错误 | 排查方法 |
SignName(签名) | 填写的签名名称包含空格或多余字符,或与代码配置不一致 | 填写已审核通过的签名全称,不得包含任何空格或特殊字符,并确保与代码中配置的名称完全一致 |
TemplateCode(模板 CODE) | 填写了错误的模板 CODE | 在模板管理页面复制正确的模板 CODE 填入;模板与签名可自由组合,无需与模板详情中的关联签名一致 |
TemplateParam(模板变量) | 变量值不符合模板定义(如验证码模板传入非纯数字),或参数格式非 JSON | 变量值须符合模板定义规范:验证码模板传 4~6 位纯数字,通知类模板按变量长度及字符类型限制传值;参数格式必须为 JSON,正确示例: |
常见错误码参考:TemplateParam.Illegal(变量格式不合规)、isv.SIGN_NAME_ILLEGAL(签名名称有误)。如遇上述错误,请优先核查对应参数的传值是否符合规范。
控制台发送测试
根据页面提示填写以下信息。
产品类型:选择发送国内短信。
签名:选择已审核通过的签名。
模板:选择已审核通过的模板。
接收号码:输入已授权(已绑定)的测试手机号码。
单击发送短信。
查询发送详情
您可以通过以下方式查询短信发送详情:
通过控制台查询:在左侧导航栏选择业务统计 > 发送记录,通过发送时间、短信内容等信息,查看短信发送详细情况。
通过API查询:在OpenAPI门户调用QuerySendDetails接口,查看发送详情。
通过回执消息:通过配置回执消息并开发对接,支持轻量消息队列消费模式和HTTP批量推送模式。
后续步骤
当您完成短信服务的测试与学习,了解短信服务使用流程后,可以根据下述步骤,开始将短信服务部署到生产环境中。
少量多次测试发送(签名报备验证 / 通道激活):签名审核通过后,状态为"已报备待验证",需通过真实发送短信来动态验证通道可用性并触发补充报备(三网测试)。若不主动发送,报备进程将十分缓慢,影响正式发送成功率。
执行建议:
覆盖移动、联通、电信三网手机号,每天每个运营商发送 10~20 条以上。
持续进行 5~7 个工作日。
支持向同一批号码重复发送,但需注意发送频率,避免触发流控。
上线标准:无需等待控制台中签名报备状态发生变更。只要实际发送成功率稳定、符合业务预期,即可将短信服务投入生产环境使用。