person/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取人员信息
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步或前端展示
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/person/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 | 每页行数 |
| code_begin | 否 | string | 起始编码 |
| code_end | 否 | string | 结束编码 |
| name | 否 | string | 名称关键字 |
| user_id | 否 | string | 操作员编码 |
| property | 否 | string | 属性 |
| timestamp_begin | 否 | string | 起始时间戳 |
| timestamp_end | 否 | string | 结束时间戳 |
3.3请求示例
GET https://api.yonyouup.com/api/person/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 | 页数 | |
| code | string | 人员编码 | |
| cuser_id | string | 操作员编码 | |
| cuser_name | string | 操作员名称 | |
| name | string | 人员名称 | |
| cdept_num | string | 部门编码 | |
| cdept_name | string | 部门名称 | |
| cpsnproperty | string | 人员属性 | |
| rsex | number | 人员性别（1:男 2:女） | |
| cpsnmobilephone | string | 人员手机号 | |
| cpsnemail | string | 人员邮箱 | |
| cjobcode | string | 职位编码 | |
| vjobname | string | 职位名称 | |
| cpsnpostaddr | string | 通讯地址 | |
| rpersontype | number | 人员类型 | |
| rpersontypename | string | 人员类型名称 | |
| rIDType | number | 证件类型（0：身份证 1：护照 2：军人证 3：港澳身份证 4：台胞证 9：其他） | |
| rEmployState | number | 雇佣状态（10：在职 20：离退 30：离职） | |
| cpsnqqcode | number | QQ号 | |
| vIDNo | string | 证件号码 | |
| bpsnperson | string | 0=非业务员；1=业务员 | |
| timestamp | number | 时间戳 | |
| bankaccount | string | openbank | 开户银行账号 |
| bankname | string | openbank | 开户银行名称 |
| defaultaccount | string | openbank | 是否为默认账户（0：否 1：为是） |
| caname | string | openbank | 账户名称 |
| cbankname | string | openbank | 所属银行名称 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"errcode":"0",
"errmsg":"",
"page_count":"51",
"page_index":"1",
"person":[
{
"cdept_name":"总裁会",
"cdept_num":"01",
"cjobcode":"0101",
"code":"00001",
"cpsnemail":"wming@yonyou.com",
"cpsnmobilephone":"18698085765",
"cuser_id":"demo",
"name":"王铭",
"openbank":[
{
"bankaccount":"4367420012340987",
"caname":"",
"defaultaccount":"0",
"openbank":"建设银行上地支行"
},
{
"bankaccount":"4367420088881111",
"caname":"王铭",
"defaultaccount":"0",
"openbank":"建设银行上地支行"
},
{
"bankaccount":"6029000012344321",
"caname":"",
"defaultaccount":"1",
"openbank":"北京银行回龙观支行"
},
{
"bankaccount":"436742009098",
"caname":"",
"defaultaccount":"0",
"openbank":"中国建设银行金融街支行"
}
],
"remploystate":"10",
"ridtype":"1",
"rpersontype":"10",
"rpersontypename":"正式员工",
"rsex":"1",
"vidno":"130903197208072011",
"vjobname":"总裁"
},
{
"cdept_name":"生产中心",
"cdept_num":"05",
"cjobcode":"0501",
"code":"00002",
"cpsnemail":"fjguo@yonyou.com",
"cpsnmobilephone":"18687983642",
"cuser_id":"demo7",
"name":"冯建国",
"openbank":[
{
"bankaccount":"4367420012345432",
"caname":"冯建国",
"code":"00002",
"defaultaccount":"0",
"icode":"B78EB897-6B27-4C83-87D2-CC824AD314B9",
"openbank":"建设银行上地支行"
}
],
"remploystate":"10",
"ridtype":"0",
"rpersontype":"10",
"rpersontypename":"正式员工",
"rsex":"1",
"vidno":"110113197701200238",
"vjobname":"生产总监"
}
],
"row_count":"101",
"rows_per_page":"2"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}