多可文档平台API
组织结构接口---创建组
新建一个组,组名称不能和父组其他子组重名,组名称不能超过1024字符,组描述不能超过512字符。如果没有权限,返回错误信息。
请求方式: POST(HTTP/HTTPS)
请求地址: /api/ou/group/add?fatherUid=UID&token=ACCESS_TOKEN
请求包示例:
{
"name":"服务部",
"remark":"描述abc",
"orderOfFather":10000
}
参数说明:
参数 | 类型 | 必须 | 说明 |
token |
string |
是 |
调用接口凭证 |
fatherUid |
string |
否 |
父组id,如果为空,直接增加到根节点 |
name |
string |
是 |
组名称,1024字符以内。 |
remark |
string |
否 |
组描述,512字符以内 |
orderOfFather |
int32 |
是 |
在父组中的排序值,值越小排序越靠前 |
返回结果示例:
{
"errcode": 0,
"errmsg": "",
"name": "服务部",
"uid": "G0010"
}
返回参数说明:
参数 | 类型 | 说明 |
errcode |
int32 |
出错返回码,为0表示成功,非0表示调用失败 |
errmsg |
string |
返回码提示语 |
uid |
string |
系统生成的组ID |
name |
string |
提交的组名称 |
权限要求: 需要目标组的【组增加删除修改】权限。