文档首页/ 云消息服务 KooMessage/ API参考/ API/ 智能信息基础版发送/ 定义智能信息基础版发送回执
更新时间：2024-11-22 GMT+08:00
查看PDF
分享

定义智能信息基础版发送回执

功能介绍

用户按照接口规格实现智能信息基础版发送状态回执接口。接口规格包括请求方式、Header参数和Body参数。

响应参数仅供参考，客户可以返回任意响应消息给平台，平台不会对响应消息处理。

URI

POST /v1/vms/send-callback

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

请求体参数类型，该字段必须设置为：application/json。
表2 请求Body参数

参数

是否必选

参数类型

描述

seq_id

否

String

本次推送请求唯一标识。

reports

否

Array of SendReport objects

状态报告列表。
表3 SendReport

参数

是否必选

参数类型

描述

task_id

否

String

智能信息基础版发送任务ID。

mobile

否

String

手机号，11位纯数字手机号码。样例：131****0000。

status

否

Integer

手机号用户下行消息接收状态。

  • 0：成功

  • 非0：失败

code

否

String

状态码。

说明：

DELIVRD表示成功，其他表示失败。

desc

否

String

状态报告错误代码的描述。

  • success：成功

  • fail：失败

stime

否

String

本条状态报告所对应的下行消息发送时间。格式：YYYY-MM-DD HH:MM:SS。

rtime

否

String

状态报告返回时间。格式：YYYY-MM-DD HH:MM:SS。

响应参数

无

请求示例

定义智能信息基础版发送状态回执。发送任务ID为"8f782063-4366-44f5-8452-8a8a3a17abd2"，手机号为"131****0000"，手机用户下行消息接收成功。

https://koomessage.myhuaweicloud.cn/v1/vms/send-callback

{
  "seq_id" : "0a96a1ac07a34e80b0e70569595e2c03",
  "reports" : [ {
    "task_id" : "8f782063-4366-44f5-8452-8a8a3a17abd2",
    "mobile" : "131****0000",
    "status" : 0,
    "code" : "DELIVRD",
    "desc" : "success",
    "stime" : "2022-11-06 20:38:33",
    "rtime" : "2022-11-06 20:38:35"
  } ]
}

响应示例

无

状态码

状态码

描述

200

返回信息。

错误码

请参见错误码。

相关文档