部门权限同步

  • 接口:/common/projectDepartmentStaffs/v2/batch
  • Method:POST
  • 数据格式:JSON
  • 限流信息:100次每天和50次每小时
  • 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
  • 接口说明:该接口用作项目部门权限的批量同步,在整批数据中如果只有几条数据因为其他原因失败,那么只有这几条数据不会被处理,其他数据仍会被正常处理
  • 其他补充信息:单次数据量过大时候(超过200条)会全部转为异步处理,具体参考回调示例

参数:

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 当前次接口同步的唯一标识 TRUE 36
timestamp long 当前次接口同步时间对应的时间戳 TRUE 13
data Array 当前接口同步的数据集合 TRUE 无
data.code String 项目编码(权限是覆盖更新,每次需要传全部权限) TRUE 无
data.staff_flag String 是否受权限管控:可传Y/N,默认为Y,传N时指不受权限管控,对所有人有权限 FALSE 1
Adata.staff_code Array 部门code(staff_flag为N是不用传该字段,staff_flag为Y时不传表示清空权限) FALSE 无
data.include_sub Map 部门权限是否包含子部门,map的key为staff_code,value为Y/N,不指定默认为N FALSE 无

返回参数

字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态码(见附录)
resMsg String 返回信息描述
created String 创建成功的条数
updated String 更新成功的条数
validatorErrors Array 字段强校验不合格的数据
dbErrors Array 数据持久化时出现错误的数据
warnings Array 字段弱校验不合格的数据,任会做同步处理

示例:

请求数据

{
    "bizId": "213231231",
    "timestamp": 1602810182941,
    "data": [
        {
            "code": "test004",
            "staff_code": [
                "D1",
                "C3"
            ],
            "include_sub": {
                "D1": "Y",
                "C3": "Y"
            },
            "staff_flag": "N"
        }
    ]
}

返回数据

{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "213231231",
    "data": {
        "validatorErrors": [],
        "warnings": [],
        "dbErrors": [],
        "updated": "此次请求同步成功了1条数据"
    }
}

results matching ""

    No results matching ""