# 开放接口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 |