首页 > 开发指南 > 通讯录管理
添加部门
更新时间: 2021-12-08 11:40:20

添加部门

请求说明

请求方式:post+application/json 方式

请求路径:https://open.71360.com/cgi/department/add

参数说明

参数参数类型必须说明
corpAccessTokenString企业应用访问公司合法性凭证
corpIdString开放平台公司帐号
department
二级对象(部门实体)
nameString部门名称(不能重复,只支持字母,数字,汉字,短横线 -, 下划线 _ )
parentIdint父部门ID(顶级部门为 0)
principalOpenUserIdString部门负责人开放平台员工账号

请求包结构体示例:

{
    "corpAccessToken":"xxxxx",
    "corpId":"corp-xxxx",
    "department": 
    { 
        "name":"部门1",
        "parentId":2,
        "principalOpenUserId": "FSUID_XXXXXXXXXXXXXXXXXX"
    }
}

返回说明

参数必须说明
errorCode返回码
errorMessage对返回码的文本描述内容
departmentId增加的部门ID
order增加的部门排序号

a) 正确的JSON返回结果示例:

{
    "errorCode":0,
    "errorMessage":"success",
    "departmentId":123,
    "order":11
}

b) 错误的JSON返回示例:

{
    "errorCode": 10013,
    "errorMessage": "the parameter corpAccessToken is missing"
}