司空云端互联
  1. 任务下发
司空云端互联
  • 司空API
    • 司空Webhook
    • 环境说明
    • 错误码
    • 码流转发
      • 码流转发流程图
      • 开始码流转发
      • 关闭码流转发
      • 获取码流转发频道转码器
    • 任务下发
      • 获取项目航线文件列表
        GET
      • 创建任务
        POST
      • 航线任务执行中指令下发
        POST
      • 航线任务轨迹获取
        GET
      • 项目设备拓扑
        GET
      • 获取任务详情
        GET
    • 获取组织下的项目列表
      GET
    • 获取指定项目的设备列表
      GET
    • 发布通知及创建地图元素
      POST
    • 获取项目临时上传凭证
      POST
    • 航线上传通知
      POST
    • 获取生成文件信息及下载地址
      GET
  1. 任务下发

项目设备拓扑

GET
/manage/api/v1.0/projects/{project_uuid}/topologies

请求参数

Path 参数
project_uuid
string 
项目uuid
必需
Header 参数
X-Organization-Key
string 
组织密钥
必需
示例值:
{{organization_key}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/manage/api/v1.0/projects//topologies' \
--header 'X-Organization-Key: {{organization_key}}' \
--header 'X-Organization-Key;'

返回响应

🟢200成功
application/json
Body
data
object 
可选
list
array [object {3}] 
可选
code
integer 
非0代表异常
可选
message
string 
消息提示
可选
示例
{
  "code": 0,
  "message": "OK",
  "data": {
    "list": [
      {
        "index": "c8449c1639b5067137f44f1165a8bed58b50ab716fe4a1ce15a917117f6c1af3",
        "host": {
          "device_sn": "1581F6Q8D242100C3W2K",
          "device_model": {
            "key": "0-91-1",
            "domain": "0",
            "type": "91",
            "sub_type": "1",
            "name": "M3TD",
            "class": "drone",
            "develop_code": "ea220t"
          },
          "device_online_status": false,
          "is_device_pending_offline": false,
          "device_offline_position": {
            "latitude": 22.77230111825499,
            "longitude": 113.51541722792594,
            "timestamp": 1718723547583
          },
          "device_project_callsign": "M3TD-2",
          "is_organization_device": false,
          "device_organization_callsign": "",
          "device_control_user_id": "",
          "device_control_user_project_callsign": "",
          "device_control_user_organization_callsign": "",
          "device_state": {
            "81-0-0": {
              "gimbal_pitch": 0,
              "gimbal_roll": 0,
              "gimbal_yaw": -97.4542114449373,
              "payload_index": "81-0-0",
              "thermal_current_palette_style": 0,
              "thermal_gain_mode": 2,
              "thermal_global_temperature_max": 31.700000762939453,
              "thermal_global_temperature_min": 29.600000381469727,
              "thermal_isotherm_lower_limit": -20,
              "thermal_isotherm_state": 0,
              "thermal_isotherm_upper_limit": 150,
              "zoom_factor": 0.5678233438485805
            },
            "activation_time": 0,
            "attitude_head": -97.3,
            "attitude_pitch": -3.1,
            "attitude_roll": 0.2,
            "battery": {
              "batteries": [
                {
                  "capacity_percent": 94,
                  "firmware_version": "26.03.00.46",
                  "high_voltage_storage_days": 1,
                  "index": 0,
                  "loop_times": 378,
                  "sn": "6Q7PL6MCAE004E",
                  "sub_type": 0,
                  "temperature": 42.2,
                  "type": 0,
                  "voltage": 16246
                }
              ],
              "capacity_percent": 94,
              "landing_power": 7,
              "remain_flight_time": 0,
              "return_home_power": 26
            },
            "best_link_gateway": "",
            "camera_watermark_settings": {
              "datetime_enable": 0,
              "drone_sn_enable": 0,
              "drone_type_enable": 0,
              "global_enable": 0,
              "gps_enable": 0,
              "layout": 0,
              "user_custom_string": "",
              "user_custom_string_enable": 0
            },
            "cameras": [
              {
                "camera_mode": 0,
                "ir_metering_mode": 0,
                "ir_metering_point": {
                  "temperature": 0,
                  "x": 0.5293588042259216,
                  "y": 0.228337436914444
                },
                "ir_zoom_factor": 2,
                "liveview_world_region": {
                  "bottom": 0.570845663547516,
                  "left": 0.4271444082260132,
                  "right": 0.5585528016090393,
                  "top": 0.4424324035644531
                },
                "payload_index": "81-0-0",
                "photo_state": 0,
                "photo_storage_settings": [
                  "vision"
                ],
                "record_time": 0,
                "recording_state": 0,
                "remain_photo_num": 9617,
                "remain_record_duration": 0,
                "screen_split_enable": false,
                "wide_calibrate_farthest_focus_value": 34,
                "wide_calibrate_nearest_focus_value": 64,
                "wide_exposure_mode": 1,
                "wide_exposure_value": 16,
                "wide_focus_mode": 2,
                "wide_focus_state": 0,
                "wide_focus_value": 35,
                "wide_iso": 8,
                "wide_max_focus_value": 64,
                "wide_min_focus_value": 35,
                "wide_shutter_speed": 45,
                "zoom_calibrate_farthest_focus_value": 34,
                "zoom_calibrate_nearest_focus_value": 64,
                "zoom_exposure_mode": 1,
                "zoom_exposure_value": 16,
                "zoom_factor": 6.999994214380596,
                "zoom_focus_mode": 2,
                "zoom_focus_state": 0,
                "zoom_focus_value": 35,
                "zoom_iso": 8,
                "zoom_max_focus_value": 64,
                "zoom_min_focus_value": 35,
                "zoom_shutter_speed": 45
              }
            ],
            "commander_flight_height": 120,
            "commander_flight_mode": 0,
            "commander_mode_lost_action": 1,
            "compatible_status": 0,
            "control_source": "B",
            "country": "CN",
            "current_commander_flight_mode": 1,
            "current_rth_mode": 1,
            "distance_limit_status": {
              "distance_limit": 5000,
              "is_near_distance_limit": 0,
              "state": 1
            },
            "dongle_infos": [
              {
                "dongle_type": 10,
                "eid": "89049032000001000000166579311507",
                "esim_activate_state": 2,
                "esim_infos": [
                  {
                    "enabled": true,
                    "iccid": "",
                    "telecom_operator": 2
                  },
                  {
                    "enabled": false,
                    "iccid": "",
                    "telecom_operator": 3
                  }
                ],
                "imei": "86328506009959",
                "sim_card_state": 0,
                "sim_info": {
                  "iccid": "89860622150001092842",
                  "sim_type": 1,
                  "telecom_operator": 0
                },
                "sim_slot": 2
              }
            ],
            "elevation": 0,
            "firmware_upgrade_status": 0,
            "firmware_version": "10.01.1301",
            "flysafe_database_version": "01.00.01.31",
            "gear": 1,
            "geo_caging_status": {
              "state": 0
            },
            "height": 7.597633361816406,
            "height_limit": 500,
            "home_distance": 0.05146747827529907,
            "home_latitude": 22.772301564192137,
            "home_longitude": 113.51541709297557,
            "horizontal_speed": 0,
            "is_near_area_limit": 1,
            "is_near_height_limit": 0,
            "latitude": 22.77230111825499,
            "locked": false,
            "longitude": 113.51541722792594,
            "low_battery_warning_threshold": 25,
            "maintain_status": {
              "maintain_status_array": [
                {
                  "last_maintain_flight_sorties": 0,
                  "last_maintain_flight_time": 0,
                  "last_maintain_time": 0,
                  "last_maintain_type": 1,
                  "state": 0
                },
                {
                  "last_maintain_flight_sorties": 0,
                  "last_maintain_flight_time": 0,
                  "last_maintain_time": 0,
                  "last_maintain_type": 2,
                  "state": 0
                },
                {
                  "last_maintain_flight_sorties": 0,
                  "last_maintain_flight_time": 0,
                  "last_maintain_time": 0,
                  "last_maintain_type": 3,
                  "state": 0
                }
              ]
            },
            "mode_code": 14,
            "mode_code_reason": 0,
            "night_lights_state": 0,
            "obstacle_avoidance": {
              "downside": 1,
              "horizon": 1,
              "upside": 1
            },
            "offline_map_enable": false,
            "payloads": [],
            "position_state": {
              "gps_number": 32,
              "is_fixed": 2,
              "quality": 5,
              "rtk_number": 38
            },
            "psdk_ui_resource": [],
            "psdk_widget_values": [],
            "rc_lost_action": 2,
            "rid_state": true,
            "rth_altitude": 250,
            "rth_mode": 1,
            "serious_low_battery_warning_threshold": 10,
            "storage": {
              "total": 60068000,
              "used": 13000
            },
            "thing_version": "1.3.0",
            "total_flight_distance": 3963814.84621529,
            "total_flight_sorties": 933,
            "total_flight_time": 441402.0501338951,
            "track_id": "",
            "uom_real_name_state": 8,
            "vertical_speed": 0,
            "wind_direction": 0,
            "wind_speed": 0,
            "wireless_link_topo": {
              "center_node": {
                "sdr_id": 914889504,
                "sn": "1581F6Q8D242100C3W2K"
              },
              "leaf_nodes": [
                {
                  "control_source_index": 2,
                  "sdr_id": 918559520,
                  "sn": "6QCDL870020174",
                  "valid": true
                }
              ],
              "secret_code": [
                0,
                0,
                0,
                0,
                1,
                0,
                0,
                0,
                24,
                27,
                234,
                155,
                71,
                15,
                150,
                197,
                19,
                3,
                143,
                117,
                165,
                57,
                141,
                114,
                204,
                111,
                106,
                254
              ]
            },
            "wpmz_version": "1.0.6"
          },
          "device_index": "",
          "parent_sns": null
        },
        "parents": [
          {
            "device_sn": "6QCDL870020174",
            "device_model": {
              "key": "3-2-0",
              "domain": "3",
              "type": "2",
              "sub_type": "0",
              "name": "DJI Dock 2",
              "class": "airport",
              "develop_code": "ea220d"
            },
            "device_online_status": true,
            "is_device_pending_offline": false,
            "device_offline_position": null,
            "device_project_callsign": "南沙B机场",
            "is_organization_device": true,
            "device_organization_callsign": "南沙B机场",
            "device_control_user_id": "",
            "device_control_user_project_callsign": "",
            "device_control_user_organization_callsign": "",
            "device_state": {
              "__state_timestamp__": "1709876819654",
              "acc_time": 21576167,
              "activation_time": 1695168350,
              "air_conditioner": {
                "air_conditioner_state": 1,
                "switch_time": 0
              },
              "air_transfer_enable": true,
              "alarm_state": 0,
              "alternate_land_point": {
                "height": 0,
                "is_configured": 0,
                "latitude": 0,
                "longitude": 0,
                "safe_land_height": 30
              },
              "backup_battery": {
                "switch": 1,
                "temperature": 37.2,
                "voltage": 13147
              },
              "battery_store_mode": 2,
              "compatible_status": 0,
              "cover_state": 0,
              "dongle_infos": [
                {
                  "dongle_type": 10,
                  "eid": "89049032000001000000166579937642",
                  "esim_activate_state": 2,
                  "esim_infos": [
                    {
                      "enabled": true,
                      "iccid": "",
                      "telecom_operator": 2
                    },
                    {
                      "enabled": false,
                      "iccid": "",
                      "telecom_operator": 3
                    }
                  ],
                  "imei": "86328506015460",
                  "sim_card_state": 0,
                  "sim_info": {
                    "iccid": "89860622150001120593",
                    "sim_type": 1,
                    "telecom_operator": 0
                  },
                  "sim_slot": 2
                }
              ],
              "drc_state": 0,
              "drone_battery_maintenance_info": {
                "batteries": [
                  {
                    "capacity_percent": 100,
                    "index": 0,
                    "temperature": 40.3,
                    "voltage": 16618
                  }
                ],
                "heat_state": 0,
                "maintenance_state": 0,
                "maintenance_time_left": 0
              },
              "drone_charge_state": {
                "capacity_percent": 100,
                "state": 0
              },
              "drone_in_dock": 1,
              "electric_supply_voltage": 32767,
              "emergency_stop_state": 0,
              "environment_temperature": 33.5,
              "firmware_upgrade_status": 0,
              "firmware_version": "10.01.1301",
              "first_power_on": 1631945855969,
              "flighttask_prepare_capacity": 1,
              "flighttask_step_code": 5,
              "heading": -95.1220703125,
              "height": 7.612299919128418,
              "home_position_is_valid": 1,
              "humidity": 91,
              "job_number": 5490,
              "latitude": 22.77230155565014,
              "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": "6QCDL870020174"
                  }
                ]
              },
              "live_status": [],
              "longitude": 113.51541704542956,
              "maintain_status": {
                "maintain_status_array": [
                  {
                    "last_maintain_time": 0,
                    "last_maintain_type": 17,
                    "last_maintain_work_sorties": 0,
                    "state": 0
                  },
                  {
                    "last_maintain_time": 0,
                    "last_maintain_type": 18,
                    "last_maintain_work_sorties": 0,
                    "state": 0
                  }
                ]
              },
              "media_file_detail": {
                "remain_upload": 0
              },
              "mode_code": 0,
              "network_state": {
                "quality": 0,
                "rate": 11,
                "type": 2
              },
              "position_state": {
                "gps_number": 7,
                "is_calibration": 1,
                "is_fixed": 2,
                "quality": 5,
                "rtk_number": 38
              },
              "putter_state": 0,
              "rainfall": 0,
              "rtcm_info": {
                "host": "120.253.226.97",
                "mount_point": "RTCM33_GRCEJ",
                "port": "8002",
                "rtcm_device_type": 1,
                "source_type": 3
              },
              "sdr": {
                "down_quality": 0,
                "frequency_band": 2.4,
                "up_quality": 100
              },
              "silent_mode": 0,
              "storage": {
                "total": 79981124,
                "used": 181548
              },
              "sub_device": {
                "device_model_key": "0-91-1",
                "device_online_status": 0,
                "device_paired": 1,
                "device_sn": "1581F6Q8D242100C3W2K"
              },
              "supplement_light_state": 0,
              "temperature": 25.4,
              "thing_version": "1.3.0",
              "user_experience_improvement": 1,
              "wind_speed": 1,
              "wireless_link": {
                "4g_freq_band": 2.4,
                "4g_gnd_quality": 0,
                "4g_link_state": 0,
                "4g_quality": 0,
                "4g_uav_quality": 0,
                "dongle_number": 1,
                "link_workmode": 1,
                "sdr_freq_band": 2.4,
                "sdr_link_state": 0,
                "sdr_quality": 0
              },
              "wireless_link_topo": {
                "center_node": {
                  "sdr_id": 914889504,
                  "sn": "1581F6Q8D242100C3W2K"
                },
                "leaf_nodes": [
                  {
                    "control_source_index": 2,
                    "sdr_id": 918559520,
                    "sn": "6QCDL870020174",
                    "valid": true
                  }
                ],
                "secret_code": [
                  0,
                  0,
                  0,
                  0,
                  1,
                  0,
                  0,
                  0,
                  24,
                  27,
                  234,
                  155,
                  71,
                  15,
                  150,
                  197,
                  19,
                  3,
                  143,
                  117,
                  165,
                  57,
                  141,
                  114,
                  204,
                  111,
                  106,
                  254
                ]
              },
              "working_current": 0,
              "working_voltage": 27390
            },
            "device_index": "B",
            "parent_sns": null
          }
        ]
      }
    ]
  }
}
上一页
航线任务轨迹获取
下一页
获取任务详情
Built with