新手必读

业务流程

短信二次开发业务整体流程如下：

1. 参考开发准备，获取调用短信API的关联数据。
2. 参考代码样例调用短信API，发起短信发送请求。
3. 根据请求响应消息，判断请求是否成功。
   • 请求成功 => 4
   • 请求失败 => 参考API错误码，修正后重新执行2
4. 根据短信发送请求，判断请求是否通过“statusCallback”参数指定了状态报告回调地址。
   • 是 => 查看接收到的状态报告
   • 否 => 登录短信控制台，进入“发送详情”页查看发送结果、状态码
5. 根据状态报告通知，判断短信是否发送成功。
   • 是 => 结束
   • 否 => 参考状态回执错误码，修正后重新执行2

调测指引

短信二次开发过程中，开发者需关注的业务调测点如下：

• Check 1：发起发送短信请求前，对请求参数合法性做必要的检查，如：
  • 请求Headers参数“Content-Type”在发送短信API中取值为application/x-www-form-urlencoded，在发送分批短信API中取值为application/json。
  • 请求Body参数“to”在发送短信API中取值为字符串，在发送分批短信API中取值为字符串数组。
  • 如果需要接收短信状态报告通知，则“statusCallback”参数值不能为空，且地址有效可达。
  • 如果“templateId”指定的模板类型为通用模板，则必须通过“signature”指定在通用模板短信内容前面补充的签名。
• Check 2：获取请求结果时，请解析出响应结果码，并参考API错误码中的处理建议进行修正。

  HTTP/1.1 200 OK
  Date: Fri, 13 Apr 2018 06:29:08 GMT
  Server: WebServer
  Content-Type: application/json;charset=UTF-8
  Content-Length: 220
  
  {"result":[{"originTo":"+8615512345678","createTime":"2018-05-25T16:34:34Z","from":"1069031221280012","smsMsgId":"d6e3cdd0-522b-4692-8304-a07553cdf591_8539659","status":"000000"}],"code":"000000","description":"Success"}

  其中，“code”取值为“E000510”时，还需解析“status”参数值，进行定位分析。

• Check 3：所发短信内容触发华为平台拦截时，华为云短信服务会推送状态报告通知给客户，请解析出状态码，并参考状态回执错误码中“状态码来源”为“华为平台”的处理建议进行修正。

  注：仅在发送短信请求中“statusCallback”参数已设置回调地址时，华为云短信服务才会推送状态报告通知。否则，请登录短信控制台，进入发送详情页查看状态码。

• Check 4：华为云短信服务收到短信中心的短信状态通知时，会推送状态报告通知给客户，请解析出状态码，并参考状态回执错误码中的处理建议进行修正。

  注：仅在发送短信请求中“statusCallback”参数已设置回调地址时，华为云短信服务才会推送状态报告通知。否则，请登录短信控制台，进入发送详情页查看状态码。