更新时间：2026-04-02 GMT+08:00

查询留言

功能介绍

查询留言

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v2/servicerequest/cases/{case_id}/messages

表1 路径参数
参数	是否必选	参数类型	描述
case_id	是	String	工单id 最小长度：0 最大长度：32

表2 Query参数
参数	是否必选	参数类型	描述
group_id	否	String	组id 最小长度：0 最大长度：64
offset	否	Integer	查询偏移量最小值：0 最大值：65535 缺省值：0
limit	否	Integer	查询数量最小值：0 最大值：100 缺省值：10
trim_osm_rich_text_label	否	Boolean	是否去除富文本, 默认值为true

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
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

表4 响应Body参数
参数	参数类型	描述
count	Integer	总数最小值：0 最大值：65535
message_list	Array of QueryMessageInfoV2 objects	留言列表数组长度：0 - 65535

表5 QueryMessageInfoV2
参数	参数类型	描述
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
iam_user_type	Integer	子用户类型，0主账号 1子账号最小值：0 最大值：3
accessory_list	Array of SimpleAccessoryV2 objects	附件列表数组长度：0 - 5
message_id	String	消息id
status	Integer	状态
display_type	String	消息展示类型， NORMAL: 普通留言, QA_BOT: 智能客服对话, EXT_PARAM_REQUEST: 索要附加参数, AUTH: 索要授权
extension	String	留言展示扩展信息

表6 SimpleAccessoryV2
参数	参数类型	描述
accessory_id	String	附件id 最小长度：0 最大长度：64
file_actual_name	String	附件实际名称最小长度：0 最大长度：256

请求示例

GET https://{endpoint}/v2/servicerequest/cases/case-123/messages

null

响应示例

状态码： 200

成功返回200

{
	"count": 1,
	"message_list": [{
		"type": 0,
		"status": 0,
		"replier": "900a6b09d9c046cc818bee82f546536d",
		"content": "【配额申请】区域：华北-乌兰察布二零三；项目：cn-north-7；产品类型：APIG；资源类型：1 ；数量：10；调整原因：WAF 业务需要调用APIG",
		"create_time": "2026-03-24T01:29:42.464+00:00",
		"message_id": "c8cb1bd9c3e9428c9fac1b050c0a166d",
		"replier_name": "qifei_30046998",
		"display_type": "NORMAL",
		"iam_user_type": 1,
		"accessory_list": []
	}]
}