绑定设备
更新于 2025-02-07调用本接口用于和组织建立绑定关系。
调用本接口前请完成对接，请填写表单并详细描述智能硬件接口的应用场景，以确保正常调用。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/smartdevice/external/bind
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用服务端API的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
device_bind_req_vo | DeviceBindReqVo | 是 | 设备请求信息。 | |
nick | String | 否 | ding | 设备昵称。 |
sn | String | 是 | sdx123d123asdf | sn地址。 |
mac | String | 否 | 11:11:11:11:11 | mac地址。 |
outid | String | 否 | 123456 | 外部设备id。 说明 开发者可以自定义此字段，如123456。 |
ext | String | 否 | ext | 扩展信息。 |
dn | String | 是 | 产品智能 | 设备名称。 |
pk | String | 是 | pk_01 | 产品的唯一标识。 说明 该参数需线下提供，请发送邮件至yuze.yl@alibaba-inc.com，并说明调用智能硬件接口的场景描述。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
result | DeviceBindRespVo | result | 返回结果。 |
device_id | String | QWR45GT | 设备ID。 |
success | Boolean | true | 请求是否成功。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
request_id | String | exz1t52e9awo | 请求ID。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
