获取
该接口用于获取公司下的所有操作日志
请求方法
GET work_logs
请求参数
| 属性 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| begin_date | 字符串 | 开始日期 | 是 |
| end_date | 字符串 | 结束日期 | 是 |
| page | 整型 | 页数 | 否, 默认为1 |
| per_page | 整型 | 每页条数, 最大50 | 否, 默认20 |
- 注：日期格式为: 'YYYY-MM-DD'
- 注：此接口只能获得90天内的操作日志
返回数据
| 属性 | 类型 | 说明 |
|---|---|---|
| code | 整型 | 执行结果码,1000代表成功 |
| meta | JSON对象 | 分页信息 |
| logs | 数组 | 日志内容,结构如下 |
- meta的数据结构
| 属性 | 类型 | 说明 |
|---|---|---|
| current_page | 整型 | 当前页号 |
| total_pages | 整型 | 总页数 |
- log的数据结构
| 属性 | 类型 | 说明 |
|---|---|---|
| id | 整型 | 业务记录模板的id |
| user_id | 字符串 | 操作人ID |
| user_nick_name | 字符串 | 操作人姓名 |
| obj_id | 整型 | 操作对象ID |
| obj_nick_name | 字符串 | 操作对象姓名 |
| device_ua | 字符串 | 终端 |
| ip | 字符串 | IP地址 |
| op_module | 字符串 | 操作模块 |
| op_type | 字符串 | 操作类型 |
| op_desc | 字符串 | 操作内容 |
| created_at | 字符串 | 操作时的时间点 |
- op_module说明
| 取值 | 说明 |
|---|---|
| sys | 系统 |
| im | 即时通讯 |
| cc | 呼叫中心 |
| ticket | 工单 |
- op_type说明
| 取值 | 说明 |
|---|---|
| sys_login | 网页登录状态 |
| sys_status | 网页在线状态 |
| im_stauts | 对话在线状态 |
| cc_work_way | 通话设备状态 |
| cc_work_state | 通话在线状态 |
| ticket_allot | 工单接收分配开关 |
示例
请求
curl -X GET 'http://demo.udesk.cn/open_api_v1/work_logs?email=admin@udesk.cn×tamp=1639119642&sign=5f17da1c4a2103185643ab5bb949545e406a65de9abaa3e529204ef3f9f54a1e&sign_version=v2&nonce=k99qp2j7tbbxvwfuhzo9sk&begin_date=2021-12-09&end_date=2021-12-10' \
响应
{
"code": 1000,
"logs":
[
{
"id": 32905,
"user_id": 741,
"user_nick_name": "wlyb3test",
"obj_id": 741,
"obj_nick_name": "wlyb3test",
"device_ua": "Browser-Windows 10 Chrome 92.0.4515",
"ip": "100.121.196.62",
"op_module": "sys",
"op_type": "sys_login",
"op_desc": "非登录 ---> 登录",
"created_at": "2021-12-09T14:06:49.000+08:00"
}
]
}
code错误码说明
| 错误码 | 错误信息 |
|---|---|
| 2059 | open api签名不对 |
| 2000 | 开始日期错误 |
| 2000 | 截止日期错误 |
| 2000 | 截止日期不能小于开始日期 |