创建组织

一、接口URL

/umsopenapi/official/organization/create

二、功能

创建组织(*注: 07:00-23:59时段同步阀值10000次/天,超出返回错误;00:00-06:59时段不做阀值限制)

三、请求参数

http header 请求参数

名称 类型 是否必传 传参方式 说明
token String true http header 调用全时API的身份验证token

http body 请求参数

名称 类型 是否必传 传参方式 说明
parentId Long true RequestBody 父组织id
name String true RequestBody 组织名称,必填。
order int false RequestBody 排序值; 值大的在下,值小的在上,非必填。
customerOrgId String false RequestBody 第三方组织id,非必填。

四、请求体

{
    "parentId": 35234231,
    "name": "测试部门",
    "order": 6
}

五、返回参数

名称 类型 说明
code Integer 结果码,0: 成功, 非0:失败 (具体描述见错误码表)
data json 返回数据,部门id
message String 错误描述
requestId String 请求唯一ID。查询接口日志时需要,建议打印日志

data参数说明

名称 类型 说明
organizationId Long 组织ID
parentId Long 组织父组织id
name String 组织名称
order int 组织排序值; 值大的在下,值小的在上
customerOrgId String 客户组织id

六、返回体

{
    "code": 0,
    "data":{
        "organizationId":12421243,
        "parentId": 35234231,
        "name": "测试组织",
        "order": 6
    },
    "message": "success",
    "requestId": "openapi-ums-165-17e9061a-adc5-4392-b160-0305fb65a0f5"
}