客服考勤明细

按客服 ID 查询指定日期的考勤状态变更明细；startTime 不传时默认查询当天，频率限制每分钟 300 次。

请求参数

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

请求体

名称	类型	必填	描述	示例值
startTime	int64	否	查询日期，传当天任意毫秒时间戳；不传默认当天	1719763200000
staffId	int64	是	客服 ID	1001

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示业务成功	200
data	object
└date	int64	查询日期当天零点的毫秒时间戳	1719763200000
└loginRecords	object[]	客服当天的登录记录
└logout	int64	登出时间，毫秒时间戳	1719820800000
└middle	object[]	登录期间的坐席状态变更记录
└eventId	int32	状态事件 ID	3
└name	string	状态变更事件名称	小休
└id	int64	状态事件记录 ID	90001
└time	int64	状态变更时间，毫秒时间戳	1719800000000
└kickOut	boolean	是否被系统踢下线	false
└login	int64	登录时间，毫秒时间戳	1719792000000
└name	string	客服姓名	张三
└id	int64	客服 ID	1001
└account	string	客服账号	zhangsan
message	string	响应消息；业务失败时为失败原因	success

错误码

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

postEndpoint

/openapi/ipcc/staff/attendance/detail

curl -X POST "https://qiyukf.com/openapi/ipcc/staff/attendance/detail?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "startTime": 1719763200000,    "staffId": 1001  }'

{
  "code": 200,
  "data": {
    "date": 1719763200000,
    "loginRecords": [
      {
        "logout": 1719820800000,
        "middle": [
          {
            "eventId": 3,
            "name": "小休",
            "id": 90001,
            "time": 1719800000000
          }
        ],
        "kickOut": false,
        "login": 1719792000000
      }
    ],
    "name": "张三",
    "id": 1001,
    "account": "zhangsan"
  },
  "message": "success"
}

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

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

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

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

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

{
  "code": 14100,
  "message": "坐席不存在"
}

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