查询指定工单详情
GET
https://open.feishu.cn/open-apis/helpdesk/v1/tickets/{ticket_id}
错误码
HTTP状态码 | 错误码 | 描述 | 排查建议 |
---|---|---|---|
400 | 154000 | Bad request, please check your request body | 请求不合法,请检查参数 |
500 | 155000 | Internal error | 内部错误,请联系我们 |
404 | 154004 | Resource not found | 资源不存在,请检查ID值 |
401 | 154001 | Unauthorized, please check you have the correct access | 检查Authorization 和 X-Lark-Helpdesk-Authorization 是否正确,应用和服务台属于同一租户 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open.feishu.cn/open-apis/helpdesk/v1/tickets/' \
--header 'Authorization;'
响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"ticket": {
"ticket_id": "6626871355780366331",
"helpdesk_id": "6626871355780366330",
"guest": {
"id": "ou_37019b7c830210acd88fdce886e25c71",
"avatar_url": "https://xxxx",
"name": "abc",
"email": "xxxx@abc.com",
"department": "用户部门名称(有权限才展示)",
"city": "城市",
"country": "国家"
},
"comments": {
"content": "备注内容",
"created_at": "备注时间",
"id": "备注id",
"user_avatar_url": "备注人头像",
"user_name": "备注人姓名",
"user_id": "备注人id"
},
"ticket_type": 1,
"status": 50,
"score": 1,
"created_at": 1616920429000,
"updated_at": 1616920429000,
"closed_at": 1616920429000,
"dissatisfaction_reason": {
"zh_cn": "答案看不懂",
"en_us": "I don't understand",
"ja_jp": "回答が複雑すぎる"
},
"agents": [
{
"id": "ou_37019b7c830210acd88fdce886e25c71",
"avatar_url": "https://xxxx",
"name": "abc",
"email": "xxxx@abc.com",
"department": "用户部门名称(有权限才展示)",
"city": "城市",
"country": "国家"
}
],
"channel": 0,
"solve": 1,
"closed_by": {
"id": "ou_37019b7c830210acd88fdce886e25c71",
"avatar_url": "https://xxxx",
"name": "abc",
"email": "xxxx@abc.com",
"department": "用户部门名称(有权限才展示)",
"city": "城市",
"country": "国家"
},
"collaborators": [
{
"id": "ou_37019b7c830210acd88fdce886e25c71",
"avatar_url": "https://xxxx",
"name": "abc",
"email": "xxxx@abc.com",
"department": "用户部门名称(有权限才展示)",
"city": "城市",
"country": "国家"
}
],
"customized_fields": [
{
"id": "123",
"value": "value",
"key_name": "key",
"display_name": "display name",
"position": 1,
"required": true,
"editable": true
}
],
"agent_service_duration": 42624.95,
"agent_first_response_duration": 123869,
"bot_service_duration": 1,
"agent_resolution_time": 66,
"actual_processing_time": 68,
"agent_entry_time": 1636444596000,
"agent_first_response_time": 1636444696000,
"agent_last_response_time": 1636444796000,
"agent_owner": {
"id": "ou_37019b7c830210acd88fdce886e25c71",
"avatar_url": "https://xxxx",
"name": "abc",
"email": "xxxx@abc.com",
"department": "用户部门名称(有权限才展示)",
"city": "城市",
"country": "国家"
}
}
}
}
请求参数
Path 参数
ticket_id
string
必需
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
返回响应
修改于 2023-02-02 06:20:06