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

工单满意度分类列表

功能介绍

工单满意度分类列表

调试

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

URI

GET /v2/servicerequest/config/satisfaction-dimensions

请求参数

表1 请求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

表2 响应Body参数

参数

参数类型

描述

total_count

Integer

总数

最小值:0

最大值:2147483647

satisfaction_dimension_list

Array of SatisfactionDimensionSimpleInfoV2 objects

满意度分类列表

satisfaction_categories

Array of 表4 SatisfactionConfigCateGory objects

满意度配置列表

表3 SatisfactionDimensionSimpleInfoV2

参数

参数类型

描述

value

Integer

总的分数

最小值:0

最大值:65535

satisfaction_id

Integer

满意度id

最小值:0

最大值:65535

satisfaction_desc

String

满意度描述

最小长度:0

最大长度:128

per_value

Integer

每格的分数

最小值:0

最大值:65535

sat_category_id

String

满意度分类id

最小长度:1

最大长度:32

表4 SatisfactionConfigCateGory

参数

参数类型

描述

category_id

String

满意度分类id

最小值:0

最大值:32

is_valid

Integer

是否有效, 1有效 0无效

最小值:0

最大值:1

type

String

类型

incident

String

普通工单满意度分类

manual-service

String

实时坐席满意度分类

sub_satisfactions

Array of 表4 SatisfactionConfigCateGory objects

满意度子分类列表

数组长度:0-10

satisfaction_dimensions

Array of 表5 SatisfactionConfigDimension objects

满意度维度列表

数组长度:0-10

category_names

Array of 表7 ConfigName objects

多语言分类名称

表5 SatisfactionConfigDimension

参数

参数类型

描述

dimension_id

String

满意度维度id

最小值:0

最大值:32

satisfaction_dimension_instances

Array of 表6 SatisfactionDimensionInstance objects

满意度维度实例列表

数组长度:0-10

dimension_names

Array of 表7 ConfigName objects

多语言维度名称

表6 SatisfactionDimensionInstance

参数

参数类型

描述

instance_id

String

满意度实例id

最小值:0

最大值:32

start_num

Integer

星数

最小值:1

最大值:5

points

Integer

分数

最小值:1

最大值:100

instance_names

Array of 表7 ConfigName objects

多语言实例名称

表7 ConfigName

参数

参数类型

描述

name

String

名称

最小值:1

最大值:32

language

String

语言

最小值:1

最大值:32

请求示例

GET https://{endpoint}/v2/servicerequest/config/satisfaction-dimensions

null

响应示例

状态码: 200

成功返回200

{
	"total_count": 2,
	"satisfaction_dimension_list": [{
		"value": 5,
		"satisfaction_id": 6,
		"per_value": 1,
		"sat_category_id": "16781abcc47047e2ba821ed0d1c95bdb"
	},
	{
		"value": 5,
		"satisfaction_id": 7,
		"per_value": 1,
		"sat_category_id": "16781abcc47047e2ba821ed0d1c95bdb"
	}],
	"satisfaction_categories": [{
		"category_id": "0460ac4dd06a4530adbfd384d9c79bc2",
		"is_valid": 1,
		"type": "incident",
		"sub_satisfactions": [{
			"category_id": "16781abcc47047e2ba821ed0d1c95bdb",
			"is_valid": 1,
			"type": "incident",
			"sub_satisfactions": [],
			"satisfaction_dimensions": [{
				"dimension_id": "12",
				"satisfaction_dimension_instances": [{
					"points": 3,
					"instance_id": "16552f113fde40499abc3462bfd5f635",
					"start_num": 3,
					"instance_names": [{
						"name": "产品功能完善度一般",
						"language": "zh-cn"
					}]
				},
				{
					"points": 4,
					"instance_id": "1bf6b6e1bbc8449f8b859bb0aa9d3e74",
					"start_num": 4,
					"instance_names": [{
						"name": "产品功能完善",
						"language": "zh-cn"
					}]
				}],
				"dimension_names": [{
					"name": "产品功能",
					"language": "zh-cn"
				}]
			}]
		}]
	}]
}

状态码

状态码

描述

200

成功返回200

错误码

请参见错误码

相关文档