配置用户消息通知URL
功能介绍
配置用户消息通知URL（增加或者更新用户消息通知URL）。 配置回调 URL 时将通过 HTTP/HTTPS 请求的方式发送一条测试请求给用户服务器，用户服务器需要处理行业视频管理服务的回调请求，并尽快进行应答。
注意事项：
回调的方向是行业视频管理服务向用户服务器发起 HTTP/HTTPS POST 请求，为了获得更高的安全性，推荐您使用 HTTPS 通道发送请求；
行业视频管理服务回调用户服务器的超时时间为 1 秒，且没有重试。如果回调超时，则配置失败。为确保回调成功率，用户服务器应当尽可能加快回调处理速度，例如先发送回调应答，然后再处理具体业务逻辑；
确保回调 URL 的 IP 和端口公网可达，以及防火墙策略不限制外网访问，接口应支持application/json格式的数据
配置回调 URL 时，云服务端会访问该地址是否可用。访问请求体格式为:
{
"message_id": 1614936351275468803, // int64 或 long 整型
"test": true // boolean 类型
}
- 注意，在配置好回调 URL，还需要给设备开通接入调阅服务和行业数据流服务后，才能接收到告警数据。
URI
POST /v1/{user_id}/messages/callback
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
user_id |
是 |
String |
用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Access-Token |
是 |
String |
用户认证token，从获取用户认证token接口获取 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
callback_url |
是 |
String |
要添加的URL，支持http和https协议，长度在256常规字符以内，不支持中文，长度范围[1,256] |
subscription_type |
是 |
String |
订阅类型字段 枚举值：
|
auth_key |
否 |
string |
鉴权秘钥：给客户推送消息时，客户认证时使用，长度范围[6,18]，该字段为非必填字段，但建议客户填写，有助于提高可靠性。 认证方式如下： 当配置了auth_key后，回调方会根据 （回调地址+"|"+时间戳+"|"+auth_key）用sha256算法做数字摘要。 在回调时，通过HEAD参数 "X-Ivm-Signature" 传递摘要，"X-Ivm-Timestamp"传递时间戳。设置方通过计算sha256(回调地址+"|"+时间戳+"|"+auth_key)进行认证，可参考告警推送消息体结构 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
callback_url |
String |
支持http/https协议，最大长度为256常规字符 |
create_time |
String |
创建时间 |
subscription_type |
String |
订阅类型字段 枚举值：
|
请求示例
POST /v1/123456789*****/messages/callback
{
"callback_url" : "http://www.xxxx.xxx/dsfa",
"subscription_type":"DEVICE_ALARM",
"auth_key":"test123456"
}
响应示例
{
"callback_url": "http://www.xxxx.xxx/dsfa",
"subscription_type": "DEVICE_ALARM",
"create_time": "2021-03-30 14:34:50",
}
状态码
请参见状态码
错误码
请参见错误码。
