部门权限

  • 接口：common/externalPersonDepartmentStaffs/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_code Array 部门code TRUE 无
data.child_include_flag String 字标记 FALSE 1

返回参数

字段名称 字段类型 字段描述
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":["D23"],
      "child_include_flag":"Y"
    }
  ]
}

返回数据

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

results matching ""

    No results matching ""