注册送短信

接口文档

API回执状态推送接口

1.1 调用地址

地址客户需向我司提交接收回执状态地址,由平台主动推送回执状态数据

推送请求方法:POST

1.2 推送请求包头定义

Content-Type: application/json;charset=utf-8

1.3 请求参数

推送数据为JSON数组形式,每次推送不大于2000条。推送字段如下:

参数名

类型

必填

说明

msgId

Long

消息id,对应发送成功时系统响应的msgId

phone

String

手机号码

status

String

回执状态,DELIVRD成功,其他失败

receiveTime

String

回执时间,格式:yyyy-MM-dd HH:mm:ss

callData

String

用户回传数据,如果提交时有传递此参数将原样推送带回

diffStatus

[Array]

当长短信拆分发送后回执状态码不一致时,会将多个片段状态码传递此参数。字符串数组格式,例如:['DELIVRD', 'MK:0001']

1.4 响应结果

正常响应HTTP状态码200即可。非200状态码将转换为客户获取形式

1.5 推送请求示例

[

{

"msgId"11600001,

"phone""13500000001",

"receiveTime""2020-06-09 11:10:32",

"status""DELIVRD"

"smsCount"1,

},

{

"msgId"11600002,

"phone""13500000002",

"receiveTime""2020-06-09 11:10:32",

"status""FAILURE"

"smsCount"1,

}

]