控制权获取 - 全新司空 2 OpenAPI V1.0

如果你需要针对特定飞行器设备的负载进行操作，需要先获取该负载设备的控制权，然后对这个负载进行操作。比如对飞行器的某个负载相机的镜头进行切换。

payload_index 参数可通过获取设备列表中data.list.drone.camera_list.camera_index传入。

请求参数

Authorization

在 header 添加参数

X-User-Token

示例：

X-User-Token: ********************

Header 参数

X-Request-Id

string <uuid>

请求唯一标识

必需

默认值:

X-Language

enum<string>

可选

枚举值:

zhen

默认值:

X-Project-Uuid

string

项目编号

可选

默认值:

X-User-Token

string

必需

X-User-Token

默认值:

Body 参数application/json

drone_sn

string

飞行器SN

必需

payload_index

array[string]

必需

负载的索引，此参数可通过获取设备列表中data.list.drone.camera_list.camera_index传入。

示例

{
  "drone_sn": "1581F6Q8D242100CPWEK",
  "payload_index": [
    "81-0-0"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

非0代表异常

必需

message

string

消息提示

必需

data

object

必需

drone_sn

string

飞行器SN

必需

controls

array [object {4}]

控制权信息

必需

示例

{
  "code": 0,
  "message": "OK",
  "data": {
    "drone_sn": "1581F6Q8D242100CPWEK",
    "controls": [
      {
        "type": "flight",
        "gateway": {
          "sn": "7CTDM3D00BZNVZ"
        },
        "user": {
          "call_sign": "",
          "user_id": "",
          "type": ""
        }
      },
      {
        "type": "payload",
        "payload_index": "81-0-0",
        "gateway": {
          "sn": ""
        },
        "user": {
          "call_sign": "",
          "user_id": "",
          "type": ""
        }
      },
      {
        "type": "payload",
        "payload_index": "80-0-0",
        "gateway": {
          "sn": "7CTDM3D00BZNVZ"
        },
        "user": {
          "call_sign": "admin",
          "user_id": "1721316169796849371",
          "type": "cloud"
        }
      }
    ]
  }
}