全新司空 2 OpenAPI V1.0
  1. 设备管理
全新司空 2 OpenAPI V1.0
  • 认证鉴权
    • 认证鉴权教程
  • 系统服务
    • 司空公有云接入点信息
    • 查询司空 2 系统状态
      GET
  • 组织项目
    • 组织项目教程
    • 获取组织下的项目列表
      GET
    • 获取组织下的设备列表
      GET
    • 获取项目下的设备列表
      GET
    • 获取项目的存储上传凭证
      GET
    • 添加人员到项目
      PUT
  • 设备管理
    • 设备管理教程
    • 物模型获取
      GET
    • HMS信息获取
      GET
    • 实时控制指令下发
      POST
    • 机场相机切换
      POST
    • 飞行器镜头切换
      POST
    • 控制权获取
      POST
    • 控制权释放
      DELETE
    • 图传清晰度设置
      PUT
    • 自定义网络RTK标定
      POST
    • 指定设备进入中继对频模式(仅支持私有云与中继设备)
      POST
    • 查询中继对频的结果(仅支持私有云与中继设备)
      GET
  • 直播管理
    • 直播管理教程
    • 直播推流
      • 开启直播
    • 旁路推流(仅支持私有云)
      • 码流转发错误码
      • 创建码流转发器
      • 开启/关闭码流转发器
      • 获取码流转码器列表
      • 删除码流转发器
  • 任务管理
    • 任务管理教程
    • 创建飞行任务
    • 更新飞行任务状态
    • 获取飞行任务信息
    • 获取飞行任务列表
    • 获取飞行任务产生的媒体资源
    • 获取飞行任务轨迹信息
  • 航线管理
    • 航线管理教程
    • 航线上传完成通知
    • 获取项目下的航线列表
    • 获取航线详情
  • 模型管理
    • 模型管理教程
    • 模型重建坐标系
    • 获取项目下的模型列表
    • 模型重建
    • 获取模型详情
  • 标注管理
    • 标注管理教程
    • 创建地图标注
  1. 设备管理

物模型获取

开发中
GET
https://es-flight-api-cn.djigate.com/openapi/v0.1/device/{device_sn}/state
物模型获取,可通过传入device_sn获取对应设备的物模型信息。

请求参数

Authorization
在 header 添加参数
X-User-Token
示例:
X-User-Token: ********************
Path 参数
device_sn
string 
必需
Header 参数
X-Request-Id
string <uuid>
请求唯一标识
必需
默认值:
{{$string.uuid}}
X-Language
enum<string> 
可选
枚举值:
zhen
默认值:
zh
X-Project-Uuid
string 
项目编号
可选
默认值:
{{X-Project-Uuid}}
X-User-Token
string 
必需
X-User-Token
默认值:
{{X-User-Token}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://es-flight-api-cn.djigate.com/openapi/v0.1/device//state' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--header 'X-User-Token;'

返回响应

🟢200成功
application/json
Body
code
integer 
非0代表异常
必需
message
string 
消息提示
必需
data
object 
必需
device_sn
string 
设备SN
必需
device_model
object 
设备模型
必需
device_state
物模型信息
必需
示例
{
  "code": 0,
  "message": "",
  "data": {
    "device_sn": "7CTDM3D00BZNVZ",
    "device_model": {
      "key": "3-2-0",
      "domain": "3",
      "type": "2",
      "sub_type": "0",
      "name": "DJI Dock 2",
      "class": "airport"
    },
    "device_state": {
      "acc_time": 16460425,
      "activation_time": 1711934979,
      "air_conditioner": {
        "air_conditioner_state": "idle_mode",
        "switch_time": 0
      },
      "air_transfer_enable": true,
      "alarm_state": "disable",
      "alternate_land_point": {
        "height": 0,
        "is_configured": "already_set",
        "latitude": 22.793230100434233,
        "longitude": 114.35781502984646,
        "safe_land_height": 30
      },
      "backup_battery": {
        "switch": "enable",
        "temperature": 26.9,
        "voltage": 815
      },
      "battery_store_mode": "standby_mode",
      "compatible_status": "no_consistency_upgrade_required",
      "cover_state": "close",
      "dongle_infos": [],
      "drone_battery_maintenance_info": {
        "batteries": [
          {
            "capacity_percent": 0,
            "index": "left_battery",
            "temperature": 0,
            "voltage": 0
          }
        ],
        "heat_state": "not_heating_or_preserving",
        "maintenance_state": "no_maintenance _equired",
        "maintenance_time_left": 0
      },
      "drone_charge_state": {
        "capacity_percent": 0,
        "state": "idle"
      },
      "drone_in_dock": "outside",
      "emergency_stop_state": "disable",
      "environment_temperature": 27.4,
      "firmware_upgrade_status": "not_upgraded",
      "firmware_version": "10.01.3205",
      "first_power_on": 1631945855969,
      "flighttask_step_code": "mission_idle",
      "heading": 112.00250244140625,
      "height": 49.58319854736328,
      "home_position_is_valid": "valid",
      "humidity": 46,
      "job_number": 3547,
      "latitude": 22.793216926533837,
      "live_capacity": {
        "available_video_number": 1,
        "coexist_video_number_max": 1,
        "device_list": [
          {
            "available_video_number": 1,
            "camera_list": [
              {
                "availabe_camera_positions": [
                  0,
                  1
                ],
                "available_video_number": 1,
                "camera_index": "165-0-7",
                "camera_position": 1,
                "coexist_video_number_max": 1,
                "video_list": [
                  {
                    "switchable_video_types": [
                      "normal"
                    ],
                    "video_index": "normal-0",
                    "video_type": "normal"
                  }
                ]
              }
            ],
            "coexist_video_number_max": 1,
            "sn": "7CTDM3D00BZNVZ"
          }
        ]
      },
      "live_status": [
        {
          "error_status": 0,
          "status": "in_live_streaming",
          "video_id": "7CTDM3D00BZNVZ/165-0-7/normal-0",
          "video_quality": "adaptive",
          "video_type": "normal"
        }
      ],
      "longitude": 114.35782881713465,
      "maintain_status": {
        "maintain_status_array": [
          {
            "last_maintain_time": 0,
            "last_maintain_type": "regular_maintenance_of_dock",
            "last_maintain_work_sorties": 0,
            "state": "no_maintenance"
          },
          {
            "last_maintain_time": 0,
            "last_maintain_type": "deep_maintenance_of_dock",
            "last_maintain_work_sorties": 0,
            "state": "no_maintenance"
          }
        ]
      },
      "media_file_detail": {
        "remain_upload": 0
      },
      "mode_code": "idle",
      "network_state": {
        "quality": "no_signal",
        "rate": 411,
        "type": "ethernet"
      },
      "position_state": {
        "gps_number": 9,
        "is_calibration": "calibrated",
        "is_fixed": "fixing_successful",
        "quality": "gear_5",
        "rtk_number": 44
      },
      "rainfall": "no_rain",
      "rtcm_info": {
        "host": "rtk.ntrip.qxwz.com",
        "mount_point": "AUTO",
        "port": "8002",
        "rtcm_device_type": "dock",
        "source_type": "network_rtk_calibration"
      },
      "silent_mode": "non_silent_mode",
      "storage": {
        "total": 79981124,
        "used": 108476
      },
      "sub_device": {
        "device_online_status": "power_off",
        "device_paired": "paired",
        "device_sn": "1581F6QAD23BU00A5318"
      },
      "supplement_light_state": "close",
      "temperature": 30.5,
      "thing_version": "1.3.1",
      "user_experience_improvement": "agree",
      "wind_speed": 2.4,
      "wireless_link": {
        "4g_freq_band": 2.4,
        "4g_gnd_quality": 0,
        "4g_link_state": "disconnect",
        "4g_quality": 0,
        "4g_uav_quality": 0,
        "dongle_number": 0,
        "link_workmode": "sdr_mode",
        "sdr_freq_band": 2.4,
        "sdr_link_state": "disconnect",
        "sdr_quality": 0
      },
      "wireless_link_topo": {
        "center_node": {
          "sdr_id": 305419896,
          "sn": "1581F6QAD23BU00A5318"
        },
        "leaf_nodes": [
          {
            "control_source_index": 2,
            "sdr_id": 846732036,
            "sn": "7CTDM3D00BZNVZ",
            "valid": true
          }
        ],
        "secret_code": [
          0,
          0,
          0,
          0,
          1,
          0,
          0,
          0,
          15,
          180,
          95,
          38,
          239,
          208,
          217,
          248,
          197,
          110,
          228,
          142,
          73,
          12,
          42,
          85,
          4,
          230,
          84,
          228
        ]
      },
      "working_current": 0,
      "working_voltage": 27863
    }
  }
}
上一页
设备管理教程
下一页
HMS信息获取
Built with