# 查询用户消息通知URL
#### 功能介绍
查询用户消息通知URL
#### URI
GET /v1/{user_id}/messages/callback
表1路径参数 
| 参数      | 是否必选 | 参数类型   | 描述                                                                                                                                                                |
|:---|:---|:---|:---|
| user_id | 是    | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215)章节 |
   
表2Query参数 
| 参数                | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| subscription_type | 是    | String | 订阅类型字段 枚举值： - **DEVICE_ALARM** 智能告警消息（含第三方告警），该消息的数据推送结构体[设备智能告警消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0069.html)  - **DEVICE_EXCEPTION** 设备异常消息，该消息的数据推送结构体[设备异常告警消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0070.html)   - **DEVICE_UNBIND** 设备解绑、套餐解绑数据，该消息的数据推送结构体[设备解绑消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0071.html)  - **TARGET_DATA** 目标TLV数据，该消息的数据推送结构体[目标数据消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0074.html)  - **THIRD_DATA** 第三方TLV数据，该消息的数据推送结构体[三方数据消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0075.html)   - **VEHICLE_DATA** 机非人TLV数据，该消息的数据推送结构体[机非人消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0076.html)  - **HEAD_SHOULDER_DATA** 头肩业务TLV数据，该消息的数据推送结构体[头肩业务消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0077.html)  - **BEHAVIOR_ANALYSIS_DATA** 行为分析TLV数据，该消息的数据推送结构体[行为分析与人车物分离消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0078.html)  - **MICRO_CHECKPOINT_DATA** 微卡口TLV数据，该消息的数据推送结构体[微卡口数据推送结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0079.html)   |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                     |
|:---|:---|:---|:---|
| Access-Token | 是    | String | 用户认证token，[从获取用户认证token接口获取](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html) |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数                | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| callback_url      | String | 支持http/https协议，最大长度为256英文字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| create_time       | String | 创建时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| update_time       | String | 更新时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| subscription_type | String | 订阅类型字段， 枚举值： - **DEVICE_ALARM** 智能告警消息（含第三方告警），该消息的数据推送结构体[设备智能告警消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0069.html)  - **DEVICE_EXCEPTION** 设备异常消息，该消息的数据推送结构体[设备异常告警消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0070.html)   - **DEVICE_UNBIND** 设备解绑、套餐解绑数据，该消息的数据推送结构体[设备解绑消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0071.html)  - **TARGET_DATA** 目标TLV数据，该消息的数据推送结构体[目标数据消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0074.html)  - **THIRD_DATA** 第三方TLV数据，该消息的数据推送结构体[三方数据消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0075.html)   - **VEHICLE_DATA** 机非人TLV数据，该消息的数据推送结构体[机非人消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0076.html)  - **HEAD_SHOULDER_DATA** 头肩业务TLV数据，该消息的数据推送结构体[头肩业务消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0077.html)  - **BEHAVIOR_ANALYSIS_DATA** 行为分析TLV数据，该消息的数据推送结构体[行为分析与人车物分离消息结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0078.html)  - **MICRO_CHECKPOINT_DATA** 微卡口TLV数据，该消息的数据推送结构体[微卡口数据推送结构体](https://support.huaweicloud.com/api-ivm/ivm_03_0079.html)   |
| auth_key          | String | 鉴权密钥                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
#### 请求示例
查询用户消息通知URL
```
GET /v1/123456789*****/messages/callback?subscription_type=DEVICE_ALARM
```
#### 响应示例
当URL存在时：
```
{
  "callback_url": "http://xxxxxx:xx",
  "subscription_type": "DEVICE_ALARM",
  "create_time": "2021-03-30 14:34:50",
  "update_time": "2021-03-30 15:34:50",
  "auth_key": "xxxxxxx"
}
```
当URL不存在时：
```
{}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html)
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)。