更新时间:2024-09-24 GMT+08:00
分享

查询质检件

场景描述

查询质检件

接口方法

POST

接口URI

https://域名/apiaccess/CCSQM/rest/ccisqm/v1/qualityitem/queryQualityItem,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

string

False

固定填 application/json; charset=UTF-8。

2

x-app-key

string

False

appKey标识

3

Authorization

string

True

鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)

4

x-UserId

string

False

操作员标识

可在登录后,进入员工管理页面,查看接口返回的userId

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1.1

fixedColumns

object

False

高级查询的条件

1.1.1

agentUserIds

array

False

座席组座席的用户ID合集

1.1.2

qualityUserIds

array

False

质检组质检员的用户ID合集

1.1.3

taskType

string

False

质检件类型(1 问题件,2 申诉件)

1.1.4

taskStatus

number

False

质检件状态(21:审核中,22:完结,24:处理中,27:核实中)

1.2

startTimeMillis

number

False

质检件开始时间,时间戳秒

1.3

endTimeMillis

number

False

质检件结束时间,时间戳秒

1.4

rows

number

False

每页条数(限制一页回传笔数,目前最大值一百万)

1.5

page

number

False

搜寻的页数,以1为底,一页大小由rows决定

响应说明

  • 响应状态码: 200
表3 响应体参数

序号

名称

参数类型

是否必选

说明

1.1

total

number

False

总条数

1.2

pages

number

False

总页数

1.3

data

array[object]

False

质检件数据

1.3.1

id

number

False

质检件标识

1.3.2

taskTypeName

string

False

申诉件类型名称

1.3.3

inspectorName

string

False

质检人员名称

1.3.4

reviewingOfficerName

string

False

复核人员名称

1.3.5

initiatorName

string

False

发起人员名称

1.3.6

taskOperatorName

string

False

处理人员名称

1.3.7

agentName

string

False

经办人名称

1.3.8

taskStatusName

string

False

申诉件状态名称

1.3.9

calls

array[object]

False

通话详情列表

1.3.9.1

call_uuid

string

False

通话质检标识

1.3.10

createTimeStr

string

False

创建时间(格式:yyyy-MM-dd)

1.3.11

updateTimeStr

string

False

更新时间(格式:yyyy-MM-dd)

1.3.12

setting

object

False

通话详情列表

1.3.12.1

file_name

string

False

文档名

1.4

pageSize

number

False

每页条数

1.5

pageNum

number

False

页码

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

错误码

无。

报文样例

  • 场景描述:查询质检件

    请求头:

    x-app-key:************************************  
    X-UserID:1611917095665261978  
    Authorization:Bearer ********************************

    请求参数:

    {
    	"rows": 10000,
    	"page": 1,
    	"startTimeMillis": 1623318494,
    	"endTimeMillis": 1623923294,
    	"fixedColumns": {
    		"agentUserIds": [],
    		"qualityUserIds": [],
    		"taskType": null,
    		"taskStatus": null
    	}
    }

    响应参数:

    {
    	"data": [{
    		"taskType": "APPEAL",
    		"calls": [{
    			"call_uuid": "8b595000-b02a-4290-9548-a4915001e89f"
    		}],
    		"initiatorName": "zxry0611",
    		"taskOperatorName": "zxzg0611",
    		"id": "16237434242323475065",
    		"taskStatus": "reviewed",
    		"createTimeStr": "2021-06-15 15:50:24",
    		"updateTimeStr": "2021-06-15 15:50:25",
    		"setting": {
    			"file_name": "a1"
    		}
    	}, {
    		"taskType": "APPEAL",
    		"calls": [{
    			"call_uuid": "473fbc39-f231-43f4-b1d7-7fc415c6e990"
    		}],
    		"initiatorName": "zxry0611",
    		"taskOperatorName": "",
    		"id": "16233956459326867354",
    		"taskStatus": "processing",
    		"createTimeStr": "2021-06-11 15:14:06",
    		"updateTimeStr": "2021-06-15 15:26:00",
    		"setting": {
    			"file_name": "a3"
    		}
    	}, {
    		"taskType": "APPEAL",
    		"calls": [{
    			"call_uuid": "473fbc39-f231-43f4-b1d7-7fc415c6e990"
    		}],
    		"initiatorName": "zxry0611",
    		"taskOperatorName": "zxry0611",
    		"id": "16233929966871311191",
    		"taskStatus": "end",
    		"createTimeStr": "2021-06-11 14:29:57",
    		"updateTimeStr": "2021-06-11 15:06:20",
    		"setting": {
    			"file_name": "a3"
    		}
    	}]
    }

相关文档