# 开放接口API说明-角色查询接口
# 角色查询接口
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/role/v1/queryRole/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 | 是 | 页码默认1。每页默认1000条，最大1000条 |
响应示例：
{
"return_code": "0",
"return_msg": null,
"msg_id": null,
"response_data": "<<DATA>>"
}
数据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 } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| role_name | VARCHAR(32) | 否 | 角色名称，可模糊搜索角色名称中含该字段的所有角色 |
| emp_code | VARCHAR(100) | 否 | 员工登录账号，可模糊搜索员工登录账号中含该字段的所有员工账号 |
| page_number | INT | 是 | 页数，每页默认1000条 |
响应示例：
{
"return_code": "0",
"return_msg": null,
"msg_id": null,
"response_data": "<<DATA>>"
}
数据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 } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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>>"
}
数据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 } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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>>"
}
数据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 |