考勤明细查询

查询指定坐席的考勤明细记录。staffId 必填。startTime 可选，默认为当天。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和

请求体

名称	类型	必填	描述	示例值
startTime	int64	否	查询日期（毫秒时间戳），不传默认当天	1685548800000
staffId	int64	是	坐席 ID	10001

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	object	客服考勤明细
└id	int64	客服 ID	10001
└name	string	客服姓名	张三
└account	string	客服账户	agent01@example.com
└date	int64	查询日期的开始时间，毫秒时间戳	1685548800000
└loginRecords	object[]	登录、上线、挂起和登出记录	[]
└login	int64	登录时间，毫秒时间戳	10
└middle	object[]	登录区间内的状态变化记录	[]
└id	int64	状态 ID	10001
└name	string	状态名称	张三
└time	int64	状态发生时间，毫秒时间戳	1720087200000
└manualOnline	int32	是否为手动上线标识	10
└eventId	int64	事件 ID	10001
└staffRecordSubDetailVO	object	客服状态变化子类型	10
└eventId	int64	事件子类型 ID	10001
└name	string	事件子类型名称	张三
└logout	int64	登出时间，毫秒时间戳	10
└kickOut	boolean	是否被强制登出	true

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体 JSON 格式错误；staffId 为空
14100	坐席不存在或已停用
14500	服务内部异常

postEndpoint

/openapi/statistic/salaryDetail

curl -X POST "https://qiyukf.com/openapi/statistic/salaryDetail?appKey=string&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef" \  -H "Content-Type: application/json" \  -d '{    "staffId": 10001  }'

{
  "code": 200,
  "message": {
    "id": 10001,
    "name": "张三",
    "account": "agent01@example.com",
    "date": 1685548800000,
    "loginRecords": []
  }
}

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

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

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

{
  "code": 14004,
  "message": "请求体 JSON 格式错误；staffId 为空"
}

{
  "code": 14100,
  "message": "坐席不存在或已停用"
}

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