七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
呼叫中心数据接口

获取咨询分类

获取企业管理后台配置的呼叫会话咨询分类,以最多五级树状结构返回;type 当前固定传 1。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳,单位秒
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0=SHA1,1=SHA256

请求体

名称类型必填描述示例值
typeint32是分类类型;当前仅支持会话咨询分类1

返回参数

名称类型描述示例值
resultobject[]咨询分类树,最多五级
└cloudboolean是否为云端预置分类false
└childrenobject[]子分类列表
└cloudboolean是否为云端预置分类false
└childrenobject[]子分类列表
└namestring分类名称售后问题
└rankint32同级分类排序值1
└idint64分类 ID30001
└namestring分类名称售后问题
└rankint32同级分类排序值1
└idint64分类 ID30001
totalint32结果总数,当前成功响应固定返回 00
codeint32业务状态码,200 表示业务成功200
messagestring响应消息success

错误码

状态码描述
12001查询过于频繁
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14200不支持的分类类型
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/category/list
POST
/openapi/ipcc/category/list
curl -X POST "https://qiyukf.com/openapi/ipcc/category/list?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "type": 1  }'
{
  "result": [
    {
      "cloud": false,
      "children": [
        {
          "cloud": false,
          "children": [],
          "name": "售后问题",
          "rank": 1,
          "id": 30001
        }
      ],
      "name": "售后问题",
      "rank": 1,
      "id": 30001
    }
  ],
  "total": 0,
  "code": 200,
  "message": "success"
}
{
  "code": 12001,
  "message": "查询过于频繁"
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求参数或内容不合法"
}
{
  "code": 14200,
  "message": "不支持的分类类型"
}
{
  "code": 14500,
  "message": "系统异常或处理超时"
}

这篇文档有帮助吗?