状态报告推送

接入流程

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

推送请求

名称	说明
推送方式	POST
Content-Type	application/json
推送地址	由客户在控制台配置，需为可公网访问的完整URL，例如 `https://your-domain.com/api/sms/report`
超时时间	5秒
重试机制	推送失败后自动重试，最多3次，间隔1分钟；3次均失败则不再推送
响应要求	客户收到推送后需返回 HTTP 200 状态码，响应体无要求，否则视为推送失败并触发重试

说明：

推送地址建议使用 HTTPS 协议，确保数据传输安全。

请确保回调接口的响应时间在5秒以内，长时间未响应将导致超时重试。

创蓝推送来源IP可联系技术支持获取，建议配置IP白名单进行安全校验。

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

登录创蓝云智控制台，进入国际短信产品，在"配置中心-数据推送"页面配置推送地址。

示例说明

当创蓝平台收到运营商返回的短信状态后，会向您在控制台配置的状态报告推送地址（如 https://your-domain.com/api/sms/report）发送 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"
}

推送 JSON 参数

参数名	类型	是否必推	描述
receiver	string	否	接收验证用户名，未配置时为空字符串，如需配置请联系技术支持
pswd	string	否	接收验证密码，未配置时为空字符串，如需配置请联系技术支持
msgid	string	是	短信提交成功后接口返回的 msgid
batchSeq	string	是	创蓝平台生成的批次号
uid	string	是	客户提交短信时传入的自定义批次号；未传时返回创蓝生成的 batchSeq
reportTime	string	是	网关平台返回的状态报告时间，13位毫秒时间戳
notifyTime	string	是	创蓝平台推送状态报告的时间，13位毫秒时间戳
requestTime	string	是	短信提交时间，13位毫秒时间戳
mobile	string	是	接收短信的手机号码，与提交时格式保持一致（如提交时带00前缀，推送也带00）
status	string	是	短信接收状态。DELIVRD 表示接收成功，其他值均为失败，详见状态报告状态码
currency	string	是	币种，如 CNY
smsNum	string	是	计费条数
unitPrice	string	是	单条短信单价
fee	string	是	费用（人民币），计算公式：fee = smsNum × unitPrice
accessNumber	string	是	接入号
countryNumber	string	是	手机号码归属国家码
regionCode	string	是	手机号码归属区域码
mnoName	string	是	手机号码所属运营商名称
mcc	string	是	手机号码所属运营商 MCC 码
mnc	string	是	手机号码所属运营商 MNC 码

产品中心

热门搜索

中国站

国际站

接入流程

推送请求

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

示例说明

推送 JSON 参数