批量注册设备
POST
/v1.0/devicemng/devices/batch最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口批量将行业设备注册到钉钉开放平台。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 制造业设备信息写权限 | API Explorer |
第三方企业应用 | 支持 | 制造业设备信息写权限 | API Explorer |
第三方个人应用 | 暂不支持 | 制造业设备信息写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | deviceNotExist | 找不到设备 | 找不到设备 |
400 | devicekeyAlreadyExist | 设备key已存在 | 设备key已存在 |
400 | devicenameAlreadyExist | 设备名称已存在 | 设备名称已存在 |
400 | deviceNumLimit | 设备数量达到上限 | 设备数量达到上限 |
400 | departmentNotExist | 部门不存在 | 部门不存在 |
500 | systemError | 系统异常 | 系统异常 |
500 | createRobotFail | 机器人创建失败 | 机器人创建失败 |
500 | createRobotException | 机器人创建异常 | 机器人创建异常 |
500 | installRobotFail | 机器人安装异常 | 机器人安装异常 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
deviceList
array [object {6}]
设备列表。
deviceKey
string
设备标识。
deviceName
string
设备名称。
departmentId
integer
部门ID。
managers
string
必需
管理员userid列表,多个userid之间使用英文逗号分隔。
collaborators
string
必需
协助者userid列表,多个userid之间使用英文逗号分隔。
description
string
设备描述。
userId
string
必需
创建者的userid。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
string
注册是否成功。
示例
{
"result": "string"
}
最后修改时间: 2 年前