同步岗位 - 组织人事

请求参数

Body 参数application/json

data

array [object {9}]

必需

name

string

岗位名称

必需

disporder

integer

显示顺序

可选

department

string

所属部门

可选

与【数据规则-部门规则】相关；例如：规则是编号，内容提供编号

parent

string

上级岗位

必需

与【数据规则-岗位规则】相关；例如：规则是编号，内容提供编号

description

string

备注

可选

code

string

岗位编号

可选

id

string

主键

可选

当【数据规则-岗位规则】为id的时候；修改岗位需要提供，其他不需要

multiObj

object

可选

is_canceled

string

是否封存

可选

0启用/1停用

dataRule

object

数据规则

可选

字段校验规则；比如指定岗位规则是名称，就按照名称规则检查唯一，如果查询到则更新；否则新增

position

string

岗位规则

必需

id:按照岗位id来检查；name:按照岗位名称来检查；code:按照岗位编号来检查

department

string

部门规则

可选

id:按照部门id来检查；name:按照组织名称来检查；code:按照部门编号来检查

extKey

string

指定需要额外返回内容的key

可选

202501基线支持；
指定报文中某个内容需要在返回报文中返回；
当指定后，返回内容将提供：extKeyMap；是map对象，并返回指定的key和其内容；

例如指定 extkey=uuid，且报文提供了uuid=1234;则返回内容额外提供：
"extKeyMap":{"uuid": "1234"}

示例

{
  "data": [
    {
      "name": "测试岗位名称",
      "parent": "人事行政经理"
    }
  ],
  "dataRule": {
    "position": "name"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/hrm/restful/syncPosition' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "name": "测试岗位名称",
            "parent": "人事行政经理"
        }
    ],
    "dataRule": {
        "position": "name"
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

api状态

必需

200 成功

msg

string

描述

必需

status

boolean

状态

必需

false 失败；true 成功

data

array [object {5}]

必需

keyValue

string

数据唯一字段值

可选

operate

string

同步操作类型

可选

add 新增、update 修改

status

string

状态

可选

SUCCESS 成功；ERROR 失败

errcode

string

失败原因

可选

needRepush

boolean

可选

示例

{
  "message": {
    "errcode": "0",
    "errmsg": "success"
  },
  "data": [
    {
      "keyValue": "测试岗位名称",
      "id": 712788378760470500,
      "operate": "ADD",
      "status": "SUCCESS",
      "errcode": "SUCCESS",
      "needRepush": false
    }
  ]
}