添加设备到账号
将设备添加到当前账号。调用时需要提供设备 ID 和设备密码，以确认你有权添加该设备。此接口需要 device:manage 权限。
端点
http
POST /wlte/v1/devices权限要求
| Scope | 必须 | 说明 |
|---|---|---|
device:manage | 是 | 将设备添加到当前账号 |
请求体
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
deviceId | string | 是 | 要关联的设备 ID |
password | string | 是 | 设备密码，必须为 4 个字符 |
name | string | 否 | 设备显示名称，最多 16 个字符；省略或传入空白内容时使用 deviceId |
请求示例
json
{
"deviceId": "rek053537488",
"password": "1234",
"name": "Office Gateway"
}成功响应
json
{
"code": "SUCCESS",
"message": "OK.",
"requestId": "7d2e2e30-36d7-4e31-9e89-c840f54185f8",
"data": {
"deviceId": "rek053537488",
"name": "Office Gateway"
}
}常见错误
| HTTP 状态码 | code | 说明 |
|---|---|---|
400 | INVALID_REQUEST | 缺少 deviceId，或 password 不是 4 个字符 |
400 | INVALID_DEVICE_PASSWORD | 设备密码不正确 |
401 | AUTH_INVALID | access token 无效或已失效 |
403 | AUTH_SCOPE_DENIED | API Client 未授予 device:manage 权限 |
409 | DEVICE_OFFLINE | 设备当前不在线，无法验证设备密码 |
409 | DEVICE_BUSY | 设备已有正在执行的请求，请稍后重试 |
429 | RATE_LIMITED | 请求过于频繁 |
503 | GATEWAY_UNAVAILABLE | 设备添加服务暂时不可用 |
504 | DEVICE_TIMEOUT | 等待设备确认超时 |