更新时间:2024-01-10 GMT+08:00

新手必读

业务流程

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

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

调测指引

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

  • 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”参数已设置回调地址时,华为云短信服务才会推送状态报告通知。否则,请登录短信控制台,进入发送详情页查看状态码。