# 开放接口API说明-角色查询接口

# 角色查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/role/v1/queryRole/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "role_name": "老板",
    "create_start_date": "2020-12-31",
    "create_end_date": "2099-12-31",
    "data_scope_type": "3",
    "page_number": 1
}

参数说明:

参数 类型 必填 说明
role_name VARCHAR(32) 角色名称,可模糊搜索角色名称中含该字段的所有角色
create_start_date CHAR(10) 角色创建的起始时间,格式:“yyyy-MM-dd”
create_end_date CHAR(10) 角色创建的终止时间,格式:“yyyy-MM-dd”
data_scope_type CHAR(1) 数据查看范围类型,查询匹配该数据查看范围的角色:包含0-查看自己及下属的数据,1-查看所有,2-所在部门及下级部门,3-查看指定部门或人员的数据
page_number INT 每页默认1000条

返回结果:

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

参数说明:

参数 类型 说明
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg VARCHAR 响应说明
msg_id VARCHAR 请求消息ID
response_data VARCHAR 响应数据体[{......}]

数据DATA示例:

[
     {
         "role_name":"1111",
         "start_date":"2021-04-01",
         "role_desc":"",
         "data_scope_type":"3",
         "end_date":"2099-12-31",
         "create_date":"2021-06-15",
         "scope":[
             {
                 "code":"xuzy1",
                 "name":"张三111",
                 "type":"1"
             },
             {
                 "code":"ceshishanchu02 ceshisc02",
                 "name":"ceshi删除02",
                 "type":"0"
             }
         ]
     }
]

参数说明:

参数 类型 说明
role_name VARCHAR(32) 角色名称
role_desc VARCHAR(2000) 角色描述
data_scope_type CHAR(1) 数据查看范围类型:包含0-查看自己及下属的数据,1-查看所有,2-所在部门及下级部门,3-查看指定部门或人员的数据
start_date CHAR(10) 角色员工关系创建的起始时间,格式:“yyyy-MM-dd”
end_date CHAR(10) 角色员工关系创建的终止时间,格式:“yyyy-MM-dd”
create_date CHAR(10) 角色员工关系的创建时间,格式:“yyyy-MM-dd”
scope[].type CHAR(1) 数据类型,包含0-部门,1-人员。如果数据查看范围类型为3-查看指定部门或人员的数据,则该子表有数据。
scope[].name VARCHAR(100) 部门名称/人员姓名。如果数据查看范围类型为3-查看指定部门或人员的数据,则该子表有数据。
scope[].code VARCHAR(4000) 部门编码/人员登录账号。如果数据查看范围类型为3-查看指定部门或人员的数据,则该子表有数据。

# 角色员工关系查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/roleUser/v1/queryRoleUser/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
	"role_name":"超级表单",
	"emp_code":"19999999999",
    "page_number":1
}

参数说明:

参数 类型 必填 说明
role_name VARCHAR(32) 角色名称,可模糊搜索角色名称中含该字段的所有角色
emp_code VARCHAR(100) 员工登录账号,可模糊搜索员工登录账号中含该字段的所有员工账号
page_number INT 页数,每页默认1000条

返回结果:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

参数说明:

参数 类型 说明
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg VARCHAR 响应说明
msg_id VARCHAR 请求消息ID
response_data VARCHAR 响应数据体[{......}]

数据DATA示例:

[
    {
        "role_name":"超级表单",
        "end_date":"2099-12-31",
        "emp_code":"19999999999",
        "star_date":"2021-04-01"
    }
]

参数说明:

参数 类型 说明
role_name VARCHAR(32) 角色名称
emp_code VARCHAR(100) 员工登录账号
start_date CHAR(10) 角色员工关系有效期的起始时间,格式:“yyyy-MM-dd”
end_date CHAR(10) 角色员工关系有效期的终止时间,格式:“yyyy-MM-dd”

# 岗位查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/job/v1/queryJob/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "waiqin365_job_id":"1",
    "job_code": "kaifa",
    "job_name":"开发",
    "job_status":"1",
    "create_date":"2021-08-09",
    "modify_date":"2021-08-09"
}

参数说明:

参数 类型 必填 说明
waiqin365_job_id VARCHAR(64) 岗位ID,根据外勤365的岗位唯一标识精确查询
job_code VARCHAR(100) 岗位编码,根据岗位编码精确查询
job_name VARCHAR(100) 岗位名称,根据岗位名称精确查询
job_status VARCHAR(1) 根据岗位状态查询: 1-启用 2-停用 0-删除
create_date VARCHAR(32) 根据创建日期查询岗位,格式:“yyyy-MM-dd”
modify_date VARCHAR(32) 根据修改日期查询岗位,格式:“yyyy-MM-dd”

返回结果:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

参数说明:

参数 类型 说明
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg VARCHAR 响应说明
msg_id VARCHAR 请求消息ID
response_data VARCHAR 响应数据体[{......}]

数据DATA示例:

[
    {
        "waiqin365_job_id":"9037794779624736886",
        "job_code":"1",
        "job_name":"ceshi",
        "job_status":"1",
        "job_sequence":"0",
        "create_date":"2021-08-02 17:13:55",
        "modify_date":"2021-08-28 17:04:04"
    },
    {
        "waiqin365_job_id":"8924298880233554809",
        "job_code":"2",
        "job_name":"kaifa",
        "job_status":"1",
        "job_sequence":"0",
        "create_date":"2021-08-02 17:14:11",
        "modify_date":"2021-08-28 17:04:04"
    }
]

参数说明:

参数 类型 说明
waiqin365_job_id VARCHAR(64) 岗位ID,外勤365的岗位唯一标识
job_code VARCHAR(100) 岗位编码
job_name VARCHAR(100) 岗位名称
job_status CHAR(1) 岗位状态: 1-启用 2-停用 0-删除
job_sequence VARCHAR(15) 岗位序号,角色员工关系有效期的终止时间,格式:“yyyy-MM-dd”
create_date VARCHAR(32) 创建时间,格式:“yyyy-MM-dd”
modify_date VARCHAR(32) 修改时间,格式:“yyyy-MM-dd”

# 职务查询接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/position/v1/queryPosition/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "waiqin365_position_id":"1",
    "position_code": "kaifa",
    "position_name":"开发",
    "position_status":"1",
    "create_date":"2021-08-09",
    "modify_date":"2021-08-09"
}

参数说明:

参数 类型 必填 说明
waiqin365_position_id VARCHAR(64) 职务ID,根据外勤365的职务唯一标识精确查询
position_code VARCHAR(100) 职务编码,根据职务编码精确查询
position_name VARCHAR(100) 职务名称,根据职务名称精确查询
position_status VARCHAR(1) 根据职务状态查询: 1-启用 2-停用 0-删除
create_date VARCHAR(32) 根据创建日期查询职务,格式:“yyyy-MM-dd”
modify_date VARCHAR(32) 根据修改日期查询职务,格式:“yyyy-MM-dd”

返回结果:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

参数说明:

参数 类型 说明
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg VARCHAR 响应说明
msg_id VARCHAR 请求消息ID
response_data VARCHAR 响应数据体[{......}]

数据DATA示例:

[
    {
        "waiqin365_position_id":"7247618738553344855",
        "position_code":"12345678",
        "position_name":"测试",
        "position_status":"1",
        "position_sequence":"0",
        "create_date":"2021-05-27 17:03:49",
        "modify_date":"2021-05-28 17:04:04"
    },
    {
        "waiqin365_position_id":"7226535608210636007",
        "position_code":"666666",
        "position_name":"开发",
        "position_status":"1",
        "position_sequence":"1",
        "create_date":"2021-05-27 17:04:04",
        "modify_date":"2021-05-28 17:04:04"
    }
]

参数说明:

参数 类型 说明
waiqin365_position_id VARCHAR(64) 职务ID,外勤365的职务唯一标识
position_code VARCHAR(100) 职务编码
position_name VARCHAR(100) 职务名称
position_status CHAR(1) 职务状态: 1-启用 2-停用 0-删除
position_sequence VARCHAR(15) 职务序号,角色员工关系有效期的终止时间,格式:“yyyy-MM-dd”
create_date VARCHAR(32) 创建时间,格式:“yyyy-MM-dd”
modify_date VARCHAR(32) 修改时间,格式:“yyyy-MM-dd”