删除设备新版SDK

更新于 2024-01-11

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

本接口用于删除注册在钉钉物联的设备，并会在钉钉物联应用-设备管理页面，移除该设备。

重要

为提升接口的使用体验，钉钉物联接口计划升级，后续完善更多功能，重新开放时间请关注文档更新日志。

钉钉物联接口相关文档，已于2023年01月02日迁移至历史文档（不推荐）目录。
不再支持新应用接入，已接入的应用可以正常调用。

说明

调用本接口，需要开通钉钉物联应用，请参考如何接入钉钉物联接口能力。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	重要暂不支持新增申请。	—
第三方企业应用	支持	重要暂不支持新增申请。	—
第三方个人应用	暂不支持	—	—

请求方法

Header参数

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。
第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

Body参数

名称

类型

是否必填

描述

corpId

String

否

钉钉物联组织ID，服务商必填。

deviceIds

Array of String

是

外部设备ID列表，最多500条。

企业内部应用，调用注册设备或者批量注册设备接口获取。
第三方企业应用，调用注册设备或者批量注册设备接口获取。

返回参数

名称	类型	描述
deviceIds	Array of String	成功删除设备ID。

错误码

HttpCode	错误码	错误信息	说明
400	parameter.error	参数错误	参数错误
401	system.not.exist	系统未注册	系统未在钉钉物联平台注册
401	corp.not.bind	组织未绑定	钉钉组织未绑定该系统
500	system.error	系统异常	系统异常
500	crop.not.install	企业未安装钉钉物联应用，请联系我们(https://open.dingtalk.com/document/orgapp-server/dingtalk-iot-overview)	企业未安装钉钉物联应用

这篇文档是否有帮助？

本页内容