attendance/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取考勤信息
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
移动考勤、考勤
3.接口调用说明
3.1请求说明
url | https://api.yonyouup.com/api/attendance/batch_get |
格式 | JSON |
https请求方式 | GET |
编码类型 | UTF-8 |
3.2url参数说明
参数 | 是否必填 | 类型 | 描述 |
---|---|---|---|
from_account | 是 | string | 调用方id |
to_account | 是 | string | 提供方id |
app_key | 是 | string | 应用编码 |
token | 是 | string | 全局访问唯一识别码 |
ds_sequence | 否 | number | 数据源序号(默认取应用的第一个数据源) |
page_index | 否 | string | 页号 |
rows_per_page | 否 | string | 每页行数 |
date_begin | 否 | date | 起始日期,格式:yyyy-MM-dd |
date_end | 否 | date | 结束日期,格式:yyyy-MM-dd |
dept_code | 否 | string | 员工所在部门的编码,可以通过 api/department 获取 |
dept_name | 否 | string | 员工所在部门的名称关键字,可以通过 api/department 获取 |
person_code | 否 | string | 员工编码,可以通过 api/person 获取 |
3.3请求示例
GET https://api.yonyouup.com/api/attendance/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&page_index=1&rows_per_page=20&ds_sequence=1
3.4返回参数说明
参数说明 | 类型 | 参数路径 | 描述 |
---|---|---|---|
errcode | string | 错误码,0 为正常。 | |
errmsg | string | 错误信息。 | |
page_index | string | 页号 | |
rows_per_page | string | 每页行数 | |
row_count | string | 总行数 | |
page_count | string | 页数 | |
personcode | string | 人员编码 | |
jobcode | string | 工号 | |
personname | string | 人员名称 | |
deptcode | string | 部门编码 | |
deptname | string | 部门名称 | |
date | date | 刷卡日期 | |
time | date | 刷卡时间 | |
datetime | date | 操作时间 | |
remark | string | 备注 | |
reason | string | 补刷原因 | |
effect | string | 状态 | |
source | string | 数据来源 | |
auditflag | string | 审核状态 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8 { "page_index":"1", "rows_per_page":"2", "row_count":"3234", "errmsg":"", "errcode":"0", "page_count":"1617", "attendance":[ { "source":"", "effect":"待确认", "personcode":"00001", "deptcode":"01", "auditflag":"未审核", "personname":"王铭", "deptname":"总裁会" }, { "time":"08:30", "source":"签卡", "effect":"有效", "reason":"免卡", "remark":"", "personcode":"00001", "deptcode":"01", "auditflag":"已审核", "date":"2014-12-01", "personname":"王铭", "deptname":"总裁会", "jobcode":"00001" } ] }
3.6错误返回示例
application/json;charset=UTF-8 { "errcode" : "30021", "errmsg" : "此应用未上线" }