发送设备固件升级指令

POST

/v2/device/upgrade/{device_id}

支持两种升级模式：
1.立即升级(immediate_upgrade=true)，要求设备在线，否则会报错
2.下次上线时自动升级(immediate_upgrade=false)，不要求设备在线

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "version": "00300300",
    "immediate_upgrade": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/device/upgrade/1702D8OBYWWQ' \
--header 'X-Tg-App-Id;' \
--header 'X-Tg-Platform;' \
--header 'X-Tg-Sdk-Version;' \
--header 'Accept-Language;' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Pkgname;' \
--header 'Authorization;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "version": "00300300",
    "immediate_upgrade": false
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "OK"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-05-10 07:50:10