创建部门
POST
/v1.0/devicemng/departments最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口为组织创建部门,部门会关联多个设备,实现对设备的管理。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 制造业设备信息写权限 | API Explorer |
第三方企业应用 | 支持 | 制造业设备信息写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 制造业设备信息写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | departmentTypeError | 部门类型不对 | 部门类型不对 |
400 | departmentAlreadyExist | 部门已存在 | 部门已存在 |
500 | systemError | 系统异常 | 系统异常 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
departmentName
string
部门名称。
departmentType
string
部门类型,取值:
systemUrl
string
业务系统地址。
authType
string
认证方式,取值:
authInfo
string
认证信息。
description
string
部门描述。
bizExt
string
业务扩展。
userId
string
必需
创建人userid。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
string
创建是否成功。
示例
{
"result": "string"
}
最后修改时间: 2 年前