---
title: "设备升级,获取升级包手动升级"
method: POST
path: "/api/v1/things/device/info/ota/upgrade"
tags: ["things/device/info", "thingsDeviceInfo"]
---

# 设备升级,获取升级包手动升级

`POST /api/v1/things/device/info/ota/upgrade`

## Request body

- DeviceOtaUpgradeReq
  - `deviceName` string, required — 设备名称
  - `productID` string, required — 产品ID
  - `version` string, required — 当前版本,如果和设备的当前版本不一致,会更新设备的版本,如果和固件的版本一致,这个固件的升级进度会变成成功

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` DeviceOtaUpgradeResp
    - `firmware` OtaUpgradeData, required
      - `desc` string, required — 文件描述
      - `extra` string, required — 额外信息
      - `files` OtaFile[], required — 升级文件列表
        - `fileMd5` string, required — 文件MD5校验值
        - `fileUrl` string, required — 文件下载地址
        - `name` string, required — 文件名
        - `signature` string, required — 文件签名值
        - `size` integer, required — 文件大小（字节）
      - `isDiff` integer, required — 是否差分升级包（0/1）
      - `name` string, required — 固件升级包名称
      - `signMethod` string, required — OTA升级包签名方法（MD5/SHA256，默认MD5）
      - `version` string, required — 新固件的版本
  - `msg` string

---

[API](https://skmtc.net/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.net/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unitedrhino/things-api/revisions/f3bdeb916389/schema)