[固件管理]查询设备固件升级进度

GET

/openapi/v0.9/manage/api/v1/organizations/{org_uuid}/devices/ota-progress

es-management-service

查询指定设备的固件升级任务进度

请求参数

Path 参数

org_uuid

string

组织UUID

必需

示例值:

4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

array[string]

可选

设备序列号列表
required: true
example: ["1581F8HHD24B10010084"]

status

array[string]

可选

状态列表
required: false
example: ["upgrading", "success"]

示例

{
    "sn": [
        "string"
    ],
    "status": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/openapi/v0.9/manage/api/v1/organizations/4dbc6ef2-0e3c-4d47-8b32-552a44f573c5/devices/ota-progress' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sn": [
        "string"
    ],
    "status": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

成功响应

Body

HTTP响应模板

code

integer

响应码

可选

message

string

响应消息

可选

data

object

dto.OtaProgressRsp

可选

响应数据

list

array[object (dto.OtaProgressRspItem) {7}]

可选

升级进度列表
required: true

示例

{
    "code": 0,
    "message": "string",
    "data": {
        "list": [
            {
                "associate_drone": {
                    "firmware_status": 0,
                    "sn": "string",
                    "working_status": 0
                },
                "associate_relay": {
                    "firmware_status": 0,
                    "sn": "string"
                },
                "device_code": 0,
                "firmware_status": 0,
                "ota": {
                    "progress": {
                        "current_step": 0,
                        "percent": 0
                    },
                    "status": "string"
                },
                "sn": "string",
                "working_status": 0
            }
        ]
    }
}

修改于 2025-06-26 08:30:29

[固件管理]发起限飞数据库升级