# 查询解析明细 #### 功能介绍 根据用户提供的过滤条件查询个性化解析明细，包括：发送任务ID、发送手机号码等。 #### URI GET /v1/aim/resolve-details 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | task_id | 否 | String | 解析任务ID或者发送任务ID。 最小长度：**0** 最大长度：**36** | | task_name | 否 | String | 任务名称。 最小长度：**0** 最大长度：**30** | | tpl_id | 否 | String | 智能信息模板ID。 最小长度：**0** 最大长度：**9** | | tpl_name | 否 | String | 智能信息模板名称。 | | cust_flag | 否 | String | 创建解析任务时填写用户唯一标识，手机号码或者任何的唯一标识，唯一标识不超过64个字符。发送智能信息时则必须填客户的手机号码。此处为手机号。样例为：130\*\*\*\*0001。 最小长度：**0** 最大长度：**64** | | sms_sign | 否 | String | 签名。 最小长度：**0** 最大长度：**18** | | aim_url | 否 | String | 智能信息短链，通过自己的短信渠道发送时，需要把该短链添加到短信模板中，并确保发送短信时的签名与创建短链时的签名保持一致。 最小长度：**0** 最大长度：**100** | | resolved_status | 否 | String | 解析状态。 - success：解析成功 - fail：解析失败 - unresolved：未解析 | | begin_time | 否 | String | 短链创建开始时间。格式为：2019-10-12T07:20:50Z。 说明： 需同时传入end_time才能生效，单独传begin_time不会作为过滤条件。缺省：查询最近二十四小时数据。 仅支持查询最近1年内创建的短链。 最小长度：**0** 最大长度：**30** | | end_time | 否 | String | 短链创建结束时间。格式为：2019-10-12T07:20:50Z。 说明： 需同时传入begin_time才能生效，单独传end_time不会作为过滤条件。缺省：查询最近二十四小时数据。 最小长度：**0** 最大长度：**30** | | offset | 是 | Integer | 偏移量，表示从此偏移量开始查询，offset大于等于0。 说明： 为提高查询效率，offset+limit须小于等于10000，超出范围查询为空。 最小值：**0** 最大值：**1000000** | | limit | 是 | Integer | 每页显示的条目数量。 最小值：**1** 最大值：**100** | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：**0** 最大长度：**2000** | #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resolve_details | Array of [AIMResolveDetail] objects | 查询解析结果集。 | | page_info | [Page] object | 分页信息。 | 表4AIMResolveDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resolve_id | String | 解析详情唯一标识ID。 | | task_id | String | 任务ID。 | | task_name | String | 任务名称。 | | send_account | String | 发送的用户名。 | | tpl_id | String | 智能信息模板ID。 | | tpl_name | String | 智能信息模板名称。 | | cust_flag | String | 创建解析任务时填写用户唯一标识，手机号码或者任何的唯一标识，唯一标识不超过64个字符。发送智能信息时则必须填客户的手机号码。此处为手机号。样例为：130\*\*\*\*0001。 | | aim_url | String | 智能信息短链，通过自己的短信渠道发送时，需要把该短链添加到短信模板中，并确保发送短信时的签名与创建短链时的签名保持一致。 | | result_code | String | 短链申请结果返回码。 - 0：成功 - 非0：失败，具体请参见错误码。 | | generate_date | String | 短链生成时间。样例为：2019-10-12T07:20:50Z。 | | expire_date | String | 短链到期时间。样例为：2019-10-12T07:20:50Z。 | | resolved_time | String | 解析时间。样例为：2019-10-12T07:20:50Z。 | | resolved_status | String | 解析状态。 - success：解析成功 - fail：解析失败 - unresolved：未解析 | 表5Page | 参数 | 参数类型 | 描述 | |:---|:---|:---| | offset | Integer | 偏移量，表示从此偏移量开始查询，offset大于等于0。 | | limit | Integer | 每页显示的条目数量。 | | total | Integer | 总条数。 | **状态码： 400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 结果状态码。 | | error_msg | String | 结果详情。 | | error_message | AnyType | 结果详情。 说明： 该字段在以后可能会废弃，建议使用error_msg字段对接。 | **状态码： 500** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 结果状态码。 | | error_msg | String | 结果详情。 | | error_message | AnyType | 结果详情。 说明： 该字段在以后可能会废弃，建议使用error_msg字段对接。 | #### 请求示例 根据模板ID查询解析任务明细。 ``` https://koomessage.myhuaweicloud.cn/v1/aim/resolve-details?tpl_id=606425661&offset=0&limit=1 ``` #### 响应示例 **状态码： 200** 返回信息。 ``` { "resolve_details" : [ { "resolve_id" : "29ae28ea-0300-4da1-8e54-6c91319fcccc", "task_id" : "bf04fc77-12c8-408f-a584-cf3d3e91cccc", "task_name" : "ZF2", "send_account" : "myaccount", "tpl_id" : "600000001", "tpl_name" : "【测试】参数通知模板", "cust_flag" : "131****0000", "aim_url" : "km2g.cn/MzNkNP", "result_code" : "0", "generate_date" : "2022-07-19T08:44:04Z", "expire_date" : "2022-07-26T08:44:04Z", "resolved_time" : "2022-07-19T08:44:31Z", "resolved_status" : "success" } ], "page_info" : { "offset" : 0, "limit" : 1, "total" : 18 } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 返回信息。 | | 400 | 非法参数。 | | 500 | 内部错误。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-koomessage/ErrorCode.html)。