帮助中心首页
开发者文档
工单系统开放接口

查询数据字典

接口说明:

数据字典包含:受理客服组、受理客服、工单分类、工单状态、工单优先级、抄送数据。

其中,受理客服组,受理客服,抄送,工单分类为动态字典项,返回数据会随企业自身配置会发生变化!

访问方式:

GET:https://www.sobot.com/ws-open/ticket/getDataDict

请求参数(Request Body):

字段编码字段名称字段类型长度可空备注说明
access_tokenToken编码string40

请求示例:

curl https://www.sobot.com/ws-open/ticket/getDataDict \
-X POST \
-H 'content-type: application/json' \
-d '
{
"access_token" : "xx"//获取access_token
}'

返回参数:

字段编码字段名称字段类型备注说明
code返回编码string
data数据对象object详见下文

返回data:

字段编码字段名称展现形式备注说明
ticketTypeList所有工单分类集合树形结构企业自定义分类,业务变化频繁
groupList受理客服组集合下拉框业务变化频繁
serviceList受理客服集合下拉框业务变化频繁,抄送数据也是这个
ticketLevelList工单优先级集合下拉框
ticketStatusList工单状态集合下拉框

集合ticketTypeList:

字段编码字段名称字段类型备注说明
typeId分类idstring
typeName分类名称string
parentId父idstring值为父级的typeId
typeLevel分类级别Integer最多三级(第一级,2:第二级,3:第三级)
nodeFlag是否为叶子节点Integer0是 1 不是
items子级集合详见下文

集合groupList:

字段编码字段名称字段类型
groupId组idstring
groupName组名称string

集合serviceList:

字段编码字段名称字段类型
serviceId客服idstring
serviceName客服名称string

集合ticketLevelList:

字段编码字段名称字段类型
dictValue优先级codestring
dictName优先级名称string

集合ticketStatusList:

字段编码字段名称字段类型
dictValue状态codestring
dictName状态名称string

返回示例:

{
"data":{
"ticketTypeList" : [{"typeId":"XX",
"typeName":"xxx",
"parentId":"xxx",
"typeLevel":0,
"nodeFlag":1,
"item":[{"typeId":"XX",
"typeName":"xxx",
"parentId":"xxx",
"typeLevel":0,
"nodeFlag":1,
"item":[{"typeId":"XX",
"typeName":"xxx",
"parentId":"xxx",
"typeLevel":0,
"nodeFlag":0
}]
}]
}],
"groupList" : [{
"groupId":"xxx",
"groupName":"xxx"
},
{
"groupId":"xxx",
"groupName":"xxx"
}
],
"serviceList" : [{
"serviceId ":"xxx",
"serviceName ":"xxx"
},
{
"serviceId ":"xxx",
"serviceName ":"xxx"
}
],
"ticketLevelList" : [{
"dictValue":"xxx",
"dictName":"xxx"
},
{
"dictValue":"xxx",
"dictName":"xxx"
}
],
"ticketStatusList" : [{
"dictValue":"xxx",
"dictName":"xxx"
},
{
"dictValue":"xxx",
"dictName":"xxx"
}
]
},
"code": "1000,正常返回!"
}