新手必读

业务流程

本节为您介绍新手开发者进行二次开发的业务流程。

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":"+86155****5678","createTime":"2018-05-25T16:34:34Z","from":"1069-******0012","smsMsgId":"d6e3cdd0-522b-4692-8304-a07553cdf591_8539659","status":"000000"}],"code":"000000","description":"Success"}

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

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

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

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

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

  如有任何疑问，请联系华为云智能客服，将有专人为您解答。