获取工单列表

更新时间：2023-06-20 12:34:13

本文介绍获取工单列表的 API。

接口描述

根据产品 ID 等参数，以分页的形式获取用户反馈工单。您也可以通过工单类型和工单状态等属性，查询工单信息。

接口地址

GET: /v1.0/iot-01/ticket/feedbacks

请求参数

参数名	类型	参数位置	是否必填	说明
req	PageQueryOrderReqVO	query	true	查询工单查询参数。

req 说明

参数名	类型	是否必填	说明
product_id	String	false	产品 ID，多个 ID 以半角逗号（,）分隔。
cate_path	String	false	工单类型 ID。
in_state_list	String	false	状态枚举值（选中多个状态用半角逗号分隔）。 `Finished`：已结单 `PendingUserFeedback`：待用户反馈 `PendingUserConfirm`：待用户确认 `Cancelled`：已撤销 `Processing`：处理中 `WaitingForDistribute`：待分配 `Pending`：待处理
page_no	Integer	false	分页页码。
page_size	Integer	false	分页页面大小。

返回参数

参数名	类型	说明
result	PageVO	返回结果。

result 说明

参数名	类型	说明
total	Integer	搜索命中总记录数。
page_size	Integer	分页页面大小。
page_no	Integer	分页页码。
list	List	分页数据。
has_more	Boolean	是否还有更多分页。

list 说明

参数名	类型	说明
ticket_no	String	工单号。
create_time	Long	创建时间。
update_time	Long	更新时间。
state_code	String	状态标识。
state_name	String	状态名。
ticket_type	String	工单类型。
handler_owner	String	工单处理权所属账号。
handler_owner_nick_name	String	工单处理权所属账号昵称。
owner_enterprise_name	String	工单处理权所属账号在涂鸦 IoT 开发平台绑定的企业名称。
handler_enterprise_name	String	工单当前处理人在涂鸦 IoT 开发平台绑定的企业名称。
handler	String	工单当前处理人。
handler_nick_name	String	工单当前处理人昵称。
description	String	详情描述。
app_name	String	应用名称。
product_name	String	产品名称。
user_account	String	用户账号。
evaluation_star	Integer	用户评价星级。
evaluation_problem_solve	Boolean	用户评价是否解决问题。
new_reply	Integer	用户新回复数量。
main_acct_id	String	工单所属账号。
is_operate	Boolean	是否有操作权限。

请求示例

GET: /v1.0/iot-01/ticket/feedbacks?productId=testxxxx&pageSIze=10&pageNo=1

返回示例

{
    "result": {
        "page_no": 1,
        "list": [
            {
                "ticket_type": "General service support/Device problems/Offline",
                "handler": "iotplatf***@yopmail.com",
                "create_time": 1638255813812,
                "handler_nick_name": "这是个昵称",
                "evaluation_star": -1,
                "handler_owner_nick_name": "昵称",
                "description": "测试回复工单",
                "is_operate": true,
                "product_name": "拼接灯",
                "app_name": "测试APPs",
                "owner_enterprise_name": "涂鸦智能",
                "update_time": 1638356077881,
                "handler_owner": "sun***@tuya.com",
                "main_acct_id": "ay15220305101785****",
                "ticket_no": "FBAY2021113****",
                "handler_enterprise_name": "杭州涂鸦信息技术有限公司",
                "user_account": "",
                "state_code": "Processing",
                "new_reply": 0
            }
        ],
        "total": 8,
        "has_more": true
    },
    "t": 1638871293544,
    "success": true
}

错误码

参考错误码。

上一篇获取沟通记录

下一篇获取用户反馈工单类型