api:api_dept_adddept

新增组织

增加新的组织架构,默认在根组织下追加。

请求地址

https://openapi.b.qq.com/api/dept/adddept

请求方式

post

请求样例

请求频率

详见频率限制

请求参数

所有向企业QQ发起的请求均包含该公共参数

此请求还需要如下参数

字段名称 字段类型 字段说明
p_dept_id int 非必填,父组织id,即在哪个组织下新增,默认为根组织1
dept_name string 必填,组织架构名称,限定长度60个字符(1个中文占2个),由大小写英文字母、数字、汉字、小数点和横杠线组成,UTF-8编码
position int 非必填,排序,即指定组织架构的具体位置,0为最前面,取值范围0~200,默认值200

返回结果

{
  "ret": 0,
  "msg": "调用成功",
  "data": {
    "dept_id": 1375832561
  }
}
字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。
data object 只有一个键dept_id,表示新添加成功的组织id。

返回

api/api_dept_adddept.txt · 最后更改: 2016/04/22 16:55 (外部编辑)