坐席当前状态报表

按客服组或客服筛选当前已登录坐席状态，可用于管理坐席和动态调整会话分配；频率限制每分钟 60 次。旧协议中业务数据以 JSON 字符串形式放在 message 中。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳，单位秒
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0=SHA1，1=SHA256

请求体

名称	类型	必填	描述	示例值
staffGroupList	int64[]	否	客服组 ID 列表；model=2 时必填
staffIdList	int64[]	否	客服 ID 列表；model=3 时必填
pageSize	int32	否	每页条数；分页接口不传或非法时按默认值处理	100
startTime	int64	否	查询开始时间，毫秒时间戳；不传 startTime/endTime 时默认最近 30 天	1719763200000
model	int32	否	查询模式：1=全部，2=按客服组，3=按客服	1
endTime	int64	否	查询结束时间，毫秒时间戳；最大跨度 90 天	1719849599000
page	int32	否	页码；分页接口不传或非法时按默认值处理	1

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示业务成功	200
message	object[]	坐席状态数组；实际响应中该数组序列化为 JSON 字符串放在 message 中	[{"id":1001,"state":"在线","stateDuration":3600000}]
└id	int64	客服 ID	1001
└state	string	坐席状态名称；小休时可能包含细分状态	在线
└stateDuration	int64	当前状态持续时长，单位毫秒	3600000

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求参数或内容不合法
14009	请求过于频繁
14500	系统异常或处理超时

postEndpoint

/openapi/ipcc/seatStatus

curl -X POST "https://qiyukf.com/openapi/ipcc/seatStatus?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "pageSize": 1000,    "model": 1,    "page": 1  }'

{
  "code": 200,
  "message": [
    {
      "id": 1001,
      "state": "在线",
      "stateDuration": 3600000
    }
  ]
}

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

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

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

{
  "code": 14004,
  "message": "请求参数或内容不合法"
}

{
  "code": 14009,
  "message": "请求过于频繁"
}

{
  "code": 14500,
  "message": "系统异常或处理超时"
}