拉取状态报告

POST

http://xxx/msg/pull/report

功能说明：开通此接口功能后，数据拉取成功后服务器会删除当前拉取成功的数据，不再保存！请用户及时存储。此状态报告保存时间为72小时，上限存储100万条。

备注：该接口默认不开放，联系客服开启。

请求

URL：http://xxx/msg/pull/report

请求方式：json格式封装的字符串，采用post方式提交请求

请求协议：http，https

编码格式：utf-8

Content-Type：application/json

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://xxx/msg/pull/report' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account": "string",
    "password": "string",
    "count": "string"
}'

响应示例

{
  "ret": 0,
  "result": [
    {
      "uid": "154789574",
      "statusDesc": "短信发送成功",
      "notifyTime": "180522104730",
      "mobile": "15744444444",
      "msgId": "18052210472127924",
      "reportTime": "1805221047",
      "status": "DELIVRD"
    }
  ]
}

请求参数

Body 参数application/json

account

string

API账号

必需

password

string

必需

API密码（8-16位）

count

string

必需

拉取个数（上限100，默认20）

示例

返回响应

🟢200成功

application/json

Body

ret

integer

必需

请求状态。0成功，其他状态为失败

result

array [object {8}]

必需

状态明细结果，没结果则返回空数组

uid

string

可选

用户在提交该短信时提交的uid参数，未提交则无该参数

statusDesc

string

可选

运营商返回的状态说明

notifyTime

string

可选

253平台收到运营商回复状态报告的时间，格式yyMMddHHmmss

mobile

string

接收短信的手机号码

可选

msgId

string

消息id

可选

reportTime

string

可选

状态更新时间，格式yyMMddHHmm，其中yy=年份的最后两位（00-99）

status

string

可选

运营商返回的状态（详细参考常见code.253.com常见状态报告状态码）

length

string

下发短信计费条数

必需

拉取上行明细接口

回送状态报告

拉取状态报告

请求#

请求参数

返回响应

请求