# 绑定设备 * **说明** > 该命令相当于用户添加新设备，用户可以通过发送此命令在服务器端注册与某个设备的关联关系，注册成功后，该设备就属于该用户，在用户设备列表中也可以查询到该设备 > pin和model可以通过配网SDK获取，具体的可以查看配网接口文档 **绑定设备会通知连接服务器刷新本地缓存** * **URL**：/v1/user/device/bind/{deviceId} * **请求方式**：POST * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **openid** | openid，每个个人用户的唯一标识 | | **ts** | 时间戳，1970年1月1日0点0分0秒到现在的**毫秒数** | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+ts+openkey+applicationkey\) | * **请求内容**： ``` （参数在URL中）设备ID：deviceId，可以通过局域网内搜索到设备ID { "timestamp": "timestamp", "pin": "pin", "model": "model", "longitude": "38.65777", "latitude": "104.08296", "name": "deviceName" } 或 { "timestamp": "timestamp", "pin": "pin", "model": "model", "name": "deviceName" } ``` | **参数名称** | **中文名称** | **类型** | **限制** | **必须** | **说明** | | :--- | :---: | :---: | :---: | :---: | :--- | | **timestamp** | 类型 | 字符串 | 13 | 是 | 调用配网sdk getRandom()方法获取| | **pin** | 类型 | 字符串 | 32 | 是 |调用配网sdk getKey()方法获取| | **model** | 型号 | 字符串 | 6 | 是 | 设备的型号，6位字符 ，可以通过局域网内搜索到型号ID| | **name** | 设备名称| 字符串 | 128 | 否 | 设备的名称| | **longitude** | 经度 | 字符串 | 合法维度 | 否 | 设备添加时的经度| | **latitude** | 维度| 字符串 | 合法经度 | 否 | 设备添加时的纬度| * **返回内容** **成功时：** > 返回内容 ``` { "code":0 } ``` **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 "bindLimit": "xxx"（达到设备最大绑定数才返回） } ```