批量注册设备新版SDK
更新于 2024-01-11
为提升接口的使用体验，行业链接相关接口正在升级，接口文档已于2021年11月08日移动至历史文档（不推荐）目录，后续重新上线时间请关注文档更新日志。
权限
要调用此API，需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
企业内部应用 | 支持 | 制造业设备信息写权限 | 暂不支持 |
第三方企业应用 | 支持 | 制造业设备信息写权限 | 暂不支持 |
第三方个人应用 | 暂不支持 | 制造业设备信息写权限 | 暂不支持 |
请求方法
Header参数
名称 | 类型 | 是否必填 | 描述 |
x-acs-dingtalk-access-token | String | 是 | 调用服务端API的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 描述 |
deviceList | Array | 是 | 设备列表。 |
deviceKey | String | 是 | 设备标识。 |
deviceName | String | 是 | 设备名称。 |
departmentId | Long | 是 | 部门ID。 |
managers | String | 是 | 管理员userid列表，多个userid之间使用英文逗号分隔。 |
collaborators | String | 是 | 协助者userid列表，多个userid之间使用英文逗号分隔。 |
description | String | 是 | 设备描述。 |
userId | String | 是 | 创建者的userid。 |
返回参数
名称 | 类型 | 描述 |
result | String | 注册是否成功。 |
示例
请求示例
返回示例
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
400 | deviceNotExist | 找不到设备 | 找不到设备 |
400 | devicekeyAlreadyExist | 设备key已存在 | 设备key已存在 |
400 | devicenameAlreadyExist | 设备名称已存在 | 设备名称已存在 |
400 | deviceNumLimit | 设备数量达到上限 | 设备数量达到上限 |
400 | departmentNotExist | 部门不存在 | 部门不存在 |
500 | systemError | 系统异常 | 系统异常 |
500 | createRobotFail | 机器人创建失败 | 机器人创建失败 |
500 | createRobotException | 机器人创建异常 | 机器人创建异常 |
500 | installRobotFail | 机器人安装异常 | 机器人安装异常 |
