查询坐席分组列表

返回该企业下所有启用的坐席分组信息。请求体中 staff 为 true 时同时返回每个分组内的坐席 ID 列表；默认不返回。仅返回 category 存在且有效的分组。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
staff	boolean	否	是否返回分组成员坐席ID列表，默认 false	true

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	object[]	坐席分组列表，仅返回 category 存在且有效的分组	[{"id":20001,"name":"售后组","staffIdList":[10001,10002,10003]}]
└id	int64	分组ID（category_id）	20001
└name	string	分组名称	售后组
└staffIdList	int64[]	分组成员坐席ID列表（仅 staff=true 时返回，默认返回空列表）	[10001,10002,10003]

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON
14500	服务内部异常

postEndpoint

/openapi/v2/staff/group/list

curl -X POST "https://qiyukf.com/openapi/v2/staff/group/list?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "code": 200,
  "message": [
    {
      "id": 20001,
      "name": "售后组",
      "staffIdList": [
        10001,
        10002,
        10003
      ]
    }
  ]
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体不是合法 JSON"
}

{
  "code": 14500,
  "message": "服务内部异常"
}