更新设备信息。

PUT

/${url.manage.prefix}${url.manage.version}/devices/{workspace_id}/devices/{device_sn}

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "deviceSn": "string",
    "deviceName": "string",
    "workspaceId": "string",
    "controlSource": "A",
    "deviceDesc": "string",
    "childDeviceSn": "string",
    "domain": "DRONE",
    "type": "M350",
    "subType": "ZERO",
    "payloadsList": [
        {
            "payloadSn": "string",
            "payloadName": "string",
            "index": 0,
            "payloadDesc": "string",
            "controlSource": "A",
            "payloadIndex": {
                "type": "M350",
                "subType": "ZERO",
                "position": "FRONT_LEFT"
            }
        }
    ],
    "iconUrl": {
        "normal_icon_url": "resource://pilot/drawable/tsa_car_normal",
        "selected_icon_url": "resource://pilot/drawable/tsa_car_select"
    },
    "status": true,
    "boundStatus": true,
    "loginTime": "string",
    "boundTime": "string",
    "nickname": "string",
    "userId": "string",
    "firmwareVersion": "string",
    "workspaceName": "string",
    "children": {},
    "firmwareStatus": "NOT_UPGRADE",
    "firmwareProgress": 0,
    "parentSn": "string",
    "thingVersion": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/$$/devices//devices/' \
--header 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ3b3Jrc3BhY2VfaWQiOiJlM2RlYTBmNS0zN2YyLTRkNzktYWU1OC00OTBhZjMyMjgwNjkiLCJzdWIiOiJDbG91ZEFwaVNhbXBsZSIsInVzZXJfdHlwZSI6IjEiLCJuYmYiOjE3NDkwODYzMDEsImxvZyI6IkxvZ2dlcltjb20uZGppLnNhbXBsZS5jb21tb24ubW9kZWwuQ3VzdG9tQ2xhaW1dIiwiaXNzIjoiREpJIiwiaWQiOiJhMTU1OWU3Yy04ZGQ4LTQ3ODAtYjk1Mi0xMDBjYzQ3OTdkYTIiLCJleHAiOjE4MzU0ODYzMDEsImlhdCI6MTc0OTA4NjMwMSwidXNlcm5hbWUiOiJhZG1pblBDIn0.W5x4fh7PWALqknARx8aoGQhK8ci5t6U7mITN1Gbn4H0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "deviceSn": "string",
    "deviceName": "string",
    "workspaceId": "string",
    "controlSource": "A",
    "deviceDesc": "string",
    "childDeviceSn": "string",
    "domain": "DRONE",
    "type": "M350",
    "subType": "ZERO",
    "payloadsList": [
        {
            "payloadSn": "string",
            "payloadName": "string",
            "index": 0,
            "payloadDesc": "string",
            "controlSource": "A",
            "payloadIndex": {
                "type": "M350",
                "subType": "ZERO",
                "position": "FRONT_LEFT"
            }
        }
    ],
    "iconUrl": {
        "normal_icon_url": "resource://pilot/drawable/tsa_car_normal",
        "selected_icon_url": "resource://pilot/drawable/tsa_car_select"
    },
    "status": true,
    "boundStatus": true,
    "loginTime": "string",
    "boundTime": "string",
    "nickname": "string",
    "userId": "string",
    "firmwareVersion": "string",
    "workspaceName": "string",
    "children": {},
    "firmwareStatus": "NOT_UPGRADE",
    "firmwareProgress": 0,
    "parentSn": "string",
    "thingVersion": "string"
}'

返回响应

🟢200成功

application/json

Body

示例

{
  "code": 0,
  "message": "",
  "data": {}
}

修改于 2025-06-27 03:15:24

移除设备的绑定状态。

提供离线固件升级任务。