文字短信接口对接发送短信后如何获取状态报告以及回复报告

上篇文章为大家介绍了文字短信如何接口对接，今天咱们来详细了解下文字短信接口对接发送短信后如何获取状态报告以及回复报告。

首先先给大家介绍下文字短信接口对接的使用场景

验证码短信

可用于验证码类型短信发送，类型定义为：短信内容属于用户主动获取，用户需要得到，而不是引导消费类型，短信内容不带有任何引导消费性质及促销性质内容。

会员通知短信

可用于通知、应用类型短信发送，短信内容不带有任何引导消费性质及促销性质内容。

会员营销短信

可用于会员营销、产品推广、优惠告知、客户关怀、生日祝福等场景。

文字短信-获取状态报告

---

此状态报告保存时间为72小时，请及时处理。单次最大返回个数为1000。

请求协议：http

请求方式：采用post方式提交请求

请求报文

action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&rece=json&timestamp=636949832321055780&sign=96E79218965EB72C92A54

参数说明

参数名称	是否必须	描述	示例
action	是	操作类型	(固定值)action=sms
username	是	账户名	username=zhangsan
password	是	账户密码，密码必须MD5加密并且取32位大写	password=E10ADC3949BA59ABBE56E057F20F883E
rece	否	返回类型json、xml，默认(json)	rece=json
timestamp	是	时间戳，13位时间戳，单位（毫秒）	timestamp=636949832321055780
sign	是	签名校验	sign=96E79218965EB72C92A54

sign参数详细说明

签名由参数action,username,password,timestamp进行MD5加密组成

比如这些值拼接后为action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&timestamp=636949832321055780，那么就MD5加密这个参数字符串得到结果后作为sign的值sign=96E79218965EB72C92A54

响应报文

参数名称	描述	示例
statusbox	状态包,无数据则返回空数组	"statusbox":[]
status	返回状态	"status": "10"
taskid	任务ID	"taskid": "159135036852978cb"
mobile	接收手机号	"mobile": "13812345678"
receivetime	报告接收时间	"receivetime": "2020-06-05 17:53:17"
errorcode	错误码	"errorcode": "DELIVRD"

JSON成功返回示例

{
    "statusbox":[
        {
            "taskid": "159135036852978cb",
            "status": "10",
            "mobile": "13812345678",
            "receivetime": "2020-06-05 17:53:17",
            "errorcode": "DELIVRD"
        }
    ]
}

JSON失败返回示例

{
    "returnstatus":"error",
    "code":"-4",
    "remark":"账户密码错误！"
}

XML成功返回示例

<?xml version="1.0" encoding="utf-8"?><returnsms>
  <statusbox>
    <taskid>159135031626323c8</taskid>
    <status>10</status>
    <mobile>17731234567</mobile>
    <receivetime>2020-06-05 17:51:25</receivetime>
    <errorcode>DELIVRD</errorcode>
  </statusbox>
</returnsms>

XML失败返回示例

<?xml version="1.0" encoding="gb2312"?><returnsms>
  <returnstatus>error</returnstatus>
  <code>-4</code>
  <remark>账户密码错误！</remark>
</returnsms>

 

文字短信-获取回复报告

---

此状态报告保存时间为120小时，请及时处理

请求协议：http

请求方式：采用post方式提交请求

请求报文

action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&rece=json&timestamp=636949832321055780&sign=96E79218965EB72C92A54

参数说明

参数名称	是否必须	描述	示例
action	是	操作类型	(固定值)action=sms
username	是	账户名	username=dashanghai
password	是	账户密码，密码必须MD5加密并且取32位大写	password=E10ADC3949BA59ABBE56E057F20F883E
rece	否	返回类型json、xml，默认(json)	rece=json
timestamp	是	时间戳，13位时间戳，单位（毫秒）	timestamp=636949832321055780
sign	是	签名校验	sign=96E79218965EB72C92A54

sign参数详细说明

签名由参数action,username,password,timestamp进行MD5加密组成

比如这些值拼接后为action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&timestamp=636949832321055780，那么就MD5加密这个参数字符串得到结果后作为sign的值sign=96E79218965EB72C92A54

响应报文

参数名称	描述	示例
callbox	无数据则返回空数组	"callbox":[]
taskid	任务ID	"taskid": "159135036852978cb"
mobile	接收手机号	"mobile": "13812345678"
receivetime	报告接收时间	"receivetime": "2020-06-05 17:53:17"

JSON成功返回示例

{
    "callbox":[
        {
            "taskid": "159135036852978cb",
            "mobile": "13812345678",
            "content": "T",
            "receivetime": "2020-06-05 17:53:17"
        }
    ]
}

JSON失败返回示例

{
    "returnstatus":"error",
    "code":"-4",
    "remark":"账户密码错误！"
}

XML成功返回示例

<?xml version="1.0" encoding="utf-8"?><returnsms>
  <callbox>
    <taskid>159135031626323c8</taskid>
    <content>T</content>
    <mobile>13812345678</mobile>
    <receivetime>2020-06-05 17:51:25</receivetime>
  </callbox>
</returnsms>

XML失败返回示例

<?xml version="1.0" encoding="gb2312"?><returnsms>
  <returnstatus>error</returnstatus>
  <code>-4</code>
  <remark>账户密码错误！</remark>
</returnsms>