状态报告推送

接入流程

需要登录控制台，在对应"API账号"的"产品配置"目录下配置获得的方式以及推送地址。

推送请求

URL：http://client_url

推送方式：POST Content-Type: application/json

推送绑定状态报告接收地址

示例说明

比如用户账户设置的短信回送地址为：http://client_url，那么当 253 平台收到运营商回送的短信状态后便会以 POST/JSON 请求您的回调地址。示例参数如下：

{
  "batchSeq": "I8393346_2506101652_35",
  "unitPrice": "0.05670",
  "countryNumber": "0086",
  "mnc": "2",
  "receiver": "account",
  "pswd": "password",
  "mnoName": "中国移动",
  "notifyTime": "1749545540975",
  "fee": "0.0567",
  "mobile": "8618888888888",
  "msgid": "627239445736452096",
  "mcc": "460",
  "requestTime": "1749545538198",
  "uid": "I8393346_2506101652_35",
  "regionCode": "CN",
  "accessNumber": "508tongdao",
  "currency": "CNY",
  "status": "DELIVRD",
  "reportTime": "1749545540967",
  "smsNum": "1"
}

注释：推送第一次不成功会推送第二次，第二次推送不成功推送第三次，第三次推送不成功就不会再推。间隔时间为 1 分钟。

推送 JSON 参数

参数名	类型	是否必推	描述
receiver	string	是	接收验证的用户名，配置时不填写则为空，如需配置请联系技术
pswd	string	是	接收验证的密码，配置时不填写则为空，如需配置请联系技术
msgid	string	是	提交短信时接口响应的 msgid
batchSeq	string	是	批次号
uid	string	是	客户方提交短信时传给我方的uid，如果没传，则为我方的batchSeq
reportTime	string	是	网关平台返回的状态报告时间，时间戳格式
notifyTime	string	是	我方推送状态报告的时间。时间戳格式
requestTime	string	是	提交短信的时间，大陆24小时制。提交短信的时间，时间戳格式。
mobile	string	是	接收短信的手机号码，推送报告里的号码，推送的格式是提交短信时的原始手机号，例如提交时区号的前面带了00，回执推送就会带00。
status	string	是	短信接收状态，"DELIVRD"代表接收成功，其他均为失败，具体含义参见状态报告状态码
currency	string	是	币种
smsNum	string	是	计费条数
unitPrice	string	是	单价，单条短信的价格。
fee	string	是	费用（人民币），当前这个号码发的短信所消耗的费用=smsNum*sellingPrice
accessNumber	string	是	接入号
countryNumber	string	是	手机号码归属国家码
regionCode	string	是	手机号码归属区域码
mnoName	string	是	手机号码所属运营商名称
mcc	string	是	手机号码所属运营商mcc
mnc	string	是	手机号码所属运营商mnc

产品中心

热门搜索

中国站

国际站

接入流程

推送请求

推送绑定状态报告接收地址

示例说明

推送 JSON 参数