查询留言
功能介绍
查询留言
URI
GET /v2/servicerequest/cases/{case_id}/messages
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
case_id | 是 | String | 工单id 最小长度：0 最大长度：64 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
group_id | 否 | String | 组id 最小长度：0 最大长度：64 |
offset | 否 | Integer | 查询偏移量 最小值：0 最大值：65535 |
limit | 否 | Integer | 查询数量 最小值：0 最大值：100 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：5000 |
X-Language | 否 | String | 语言环境，值为通用的语言描述字符串，比如zh-cn等，默认为zh-cn。 会根据语言环境对应展示一些国际化的信息，比如工单类型名称等。 最小长度：1 最大长度：32 |
X-Time-Zone | 否 | String | 环境时区，值为通用的时区描述字符串，比如GMT+8等，默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度：1 最大长度：32 |
响应参数
状态码： 200
参数 | 参数类型 | 描述 |
|---|---|---|
count | Integer | 总数 最小值：0 最大值：65535 |
message_list | Array of QueryMessageInfoV2 objects | 留言列表 数组长度：0 - 65535 |
参数 | 参数类型 | 描述 |
|---|---|---|
type | Integer | 类型，可以删除 0是客户留言 1是客服回留言 最小值：0 最大值：1 |
replier_type | Integer | 回复人类型，0客户留言 1客服留言 最小值：0 最大值：3 |
replier | String | 回复人id 最小长度：0 最大长度：64 |
content | String | 留言内容 最小长度：0 最大长度：400 |
create_time | String | 创建时间 |
replier_name | String | 回复人名称 最小长度：0 最大长度：256 |
is_first_message | Integer | 是否是第一条留言 最小值：0 最大值：1 |
iam_user_type | Integer | 子用户类型，0主账号 1子账号 最小值：0 最大值：3 |
accessory_list | Array of SimpleAccessoryV2 objects | 附件列表 数组长度：0 - 5 |
请求示例
GET https://{endpoint}/v2/servicerequest/cases/case-123/messages
null 响应示例
状态码： 200
成功返回200
{
"count" : 1,
"message_list" : [ {
"type" : 0,
"replier" : "test",
"content" : "test",
"create_time" : "2020-07-09 00:00:00",
"replier_name" : "test",
"is_first_message" : 1,
"iam_user_type" : 0,
"accessory_list" : [ {
"accessory_id" : "123",
"file_actual_name" : "test"
} ]
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | 成功返回200 |
错误码
请参见错误码。
