文档首页/ IoT云通信 IoTCom/ API参考/ 推送状态报告
更新时间：2023-08-03 GMT+08:00
查看PDF
分享

推送状态报告

接口功能

IoT云通信主动向用户推送状态报告。

接口地址

表1 接口地址

项目

描述

消息方向

IoT云通信-> SP

方法

HTTPS + POST

URI

https://{IP:Port}/common/sms/notifyReportMessage

说明：
  • IP:Port表示客户平台的IP和端口号，由客户提供给iTA平台，用于推送状态报告给客户。
  • 该URI来源于“发送短信”接口请求消息中的“statusCallback”字段，详细解释请参见发送短信接口。

请求消息

表2 请求消息

参数列表

类型

必选/可选

最大长度

描述信息

requestId

String

可选

20

用于与下发消息时的requestId进行关联。

mobile

String

必选

20

手机号码。与原始下发请求中的手机号码一致。以国家码开头。示例：8613600000000。

其中，国内短信可以不带国家码，示例：13600000000。

messageId

String

必选

32

消息ID，与原始下发响应返回的messageId一致。

status

String

必选

10

短信下发状态码。

resultCode

String

可选

6

结果码。

resultDesc

String

可选

100

结果码描述。

smsCount

int

可选

2

长短信拆分的条数。

receiveTime

String

可选

36

终端用户收到短信的时间。

请求消息示例：

{

"messageId": "12345",

"mobile": "12345678911",

"receiveTime": "2016-05-29 10:55:23",

"status": "DELIVED",

"smsCount":2

}

响应消息

表3 响应消息

参数列表

类型

必选/可选

最大长度

描述信息

resultCode

String

必选

6

结果码。

resultDesc

String

可选

100

结果描述。

响应样例如下。

{

"resultCode": "0"

}

相关文档