批次设备列表

POST

/api/v1/things/ota/task/device-index

iThings-apisvr/物联网相关接口/ota升级

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Header 参数

iThings-token

string

可选

默认值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODcwMTUyMDYsImlhdCI6MTY4NzAwOTMxMn0.xxFiBpYlTIDLYhN-_stlrmYGOLqF-wHJKBSqs-zVb8k

iThings-project-id

string

可选

默认值:

123123123

Body 参数application/json

taskUid

string

必需

deviceName

string

设备编号

可选

status

integer <int32>

可选

升级状态:101待确认 201/202/203待推送 301已推送 401升级中 501升级成功 601升级失败 701已取消

page

object (PageInfo)

可选

page

integer <int64>

页码

可选

>= 1<= 2

默认值:

size

integer <int64>

每页大小

可选

>= 10<= 20

默认值:

示例

{
  "taskUid": "string",
  "deviceName": "string",
  "status": 0,
  "page": {
    "page": 1,
    "size": 20
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://42.193.250.251:7777/api/v1/things/ota/task/device-index' \
--header 'iThings-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODcwMTUyMDYsImlhdCI6MTY4NzAwOTMxMn0.xxFiBpYlTIDLYhN-_stlrmYGOLqF-wHJKBSqs-zVb8k' \
--header 'iThings-project-id: 123123123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "taskUid": "string",
    "deviceName": "string",
    "status": 0,
    "page": {
        "page": 1,
        "size": 20
    }
}'

返回响应

🟢200A successful response.

application/json

Body

list

array[object (OtaTaskDeviceInfo) {6}]

必需

integer <int64>

必需

taskUid

string

必需

deviceName

string

设备编号

必需

version

string

当前版本

必需

status

integer <int32>

必需

升级状态:101待确认 201/202/203待推送 301已推送 401升级中 501升级成功 601升级失败 701已取消

updatedTime

integer <int64>

状态更新时间只读

必需

total

integer <int64>

总数

必需

示例

{
  "list": [
    {
      "id": 0,
      "taskUid": "string",
      "deviceName": "string",
      "version": "string",
      "status": 0,
      "updatedTime": 0
    }
  ],
  "total": 0
}

修改于 2023-06-18 13:44:36

更新升级包

获取升级包直传的signed url