批量新增/修改组织

请求参数

Query 参数

project

string

可选

项目id或者项目编码。可由实施提供或者通过项目列表接口获取(http://aiot.docs.chn-das.com/api-139664251)

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Authorization

string

jwt凭证

必需

示例值:

Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJVamdBcm4wcyIsInNlcnZlciI6dHJ1ZSwidXNlcl9uYW1lIjoi5rWL6K-V562W55WlIiwic2NvcGUiOlsic2VydmVyIl0sIm5hbWUiOiLmtYvor5XnrZbnlaUiLCJwcm9qZWN0IjoiNDA5ODE4NDY2MTYwNzA5IiwiZXhwIjoxNjg0ODcxMjYwLCJ0ZW5hbnQiOiJ0NDA5ODE4NDY2MTYwNzA5IiwiY2xpZW50X2lkIjoic3lzIn0._E-RDguiasgicVmdYdOs4dsI_oKVsOremFWLENLzGyI

Body 参数application/json

data

array [object {8}]

数据

必需

id

string

来源方组织ID

必需

租户下唯一

code

string

组织编码

可选

租户下唯一，新增时不能为空，不支持修改，修改时忽略该字段

name

string

组织名称

可选

新增时不能为空，修改时如果为空则不更新该字段，否则覆盖

type

integer

组织类型

可选

2：公司 3：区域 4：分公司 5：子公司 6：管理 8：部门 9：组，新增时不能为空，修改时如果为空则不更新该字段，否则覆盖

description

string

描述信息

可选

修改时如果为null则不更新该字段，否则覆盖

parentId

string

来源方上级组织ID

可选

新增时为空则默认挂靠顶级组织节点，修改时如果为null则不更新该字段，否则覆盖，顶级组织节点即租户

order

integer

排序

可选

组织节点在当前层级的排序值，修改时如果为null则不更新该字段，否则覆盖

params

object

组织参数（扩展字段）

可选

字典结构，用于存储接口调用方的业务字段，包含组织等级等业务字段，修改时如果key为空则不更新该字段，否则覆盖（key为组织参数编码，需要提前创建).在调用组织查询接口时，会将组织参数数据返回。示例：组织状态，提前创建组织参数status，传参时按"params": { "status": "1"}格式。

dataSyncRule

integer

同步规则

可选

1：组织ID存在时更新 2：组织ID存在时跳过不更新。默认值1

示例

{
  "data": [
    {
      "id": "2",
      "name": "深圳总公司",
      "code": "szzgs",
      "type": 1,
      "description": "",
      "parentId": "1",
      "order": 1,
      "params": {
        "status": "1"
      }
    }
  ],
  "dataSyncRule": 1
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://prod-cn.your-api-server.com/api/open/enterpriseright/org-manage/v1/external/org/batch?project=1192410229407772672&instance=' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJVamdBcm4wcyIsInNlcnZlciI6dHJ1ZSwidXNlcl9uYW1lIjoi5rWL6K-V562W55WlIiwic2NvcGUiOlsic2VydmVyIl0sIm5hbWUiOiLmtYvor5XnrZbnlaUiLCJwcm9qZWN0IjoiNDA5ODE4NDY2MTYwNzA5IiwiZXhwIjoxNjg0ODcxMjYwLCJ0ZW5hbnQiOiJ0NDA5ODE4NDY2MTYwNzA5IiwiY2xpZW50X2lkIjoic3lzIn0._E-RDguiasgicVmdYdOs4dsI_oKVsOremFWLENLzGyI' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "id": "2",
            "name": "深圳总公司",
            "code": "szzgs",
            "type": 1,            
            "description": "",
            "parentId": "1",
            "order": 1,
            "params": {
                "status": "1"
            }
        }
    ],
    "dataSyncRule": 1
}'

返回响应

🟢200成功

application/json

Body

data

array [object {3}]

异常数据

必需

id

string

来源方组织ID

必需

status

string

错误编码

必需

msg

string

错误描述

必需

示例

{
  "data": [
    {
      "id": "1",
      "status": "ORG_CODE_EXISTS",
      "msg": "组织编码已存在"
    }
  ]
}

🟠400400响应结构