修改设备昵称旧版SDK
更新于 2025-02-07
接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。
重要
调用本接口前请完成对接，请填写表单并详细描述智能硬件接口的应用场景，以确保正常调用。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/smartdevice/device/updatenick
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用服务端API的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
device_nick_modify_vo | DeviceNickModifyVo | 否 | 昵称修改参数。 | |
pk | String | 是 | pk_01 | 产品的唯一标识。 说明 该参数需要线下提供， 请发送邮件至yuze.yl@alibaba-inc.com，并说明调用智能硬件接口的场景描述。 |
device_name | String | 否 | 产品智能 | 设备名称： 说明 该参数不能和设备id同时为空。 |
device_id | String | 否 | QWR45GT | 设备id： 说明 该参数不能和设备名称同时为空。 |
nick | String | 是 | newding | 新的设备昵称。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
success | Boolean | true | 请求是否成功。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
request_id | String | exz1t52e9awo | 请求ID。 |
示例
请求示例（HTTP）
Loading...
请求正文
Loading...
请求示例（JAVA SDK）
Loading...
返回示例
Loading...
