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

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

验证码短信

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

会员通知短信

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

会员营销短信

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

文字短信-获取状态报告

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

请求协议：http

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

请求报文

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

参数说明

sign参数详细说明

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

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

响应报文

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

参数说明

sign参数详细说明

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

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

响应报文

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>