基础档案类

    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" : "此应用未上线"
    } 

    4.API测试

    API测试 SDK下载