彩信-获取状态报告

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

请求地址

GBK编码请求地址：http://www.lokapi.cn/statusApiGBK.aspx

UTF8编码请求地址：http://www.lokapi.cn/statusApi.aspx

请求协议：http

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

请求报文

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

参数说明

参数名称	是否必须	描述	示例
action	是	操作类型	(固定值)action=imagetext
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=imagetext&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>

1.4.3 获取状态报告