司空云端互联
  1. 任务下发
司空云端互联
  • 司空API
    • 司空Webhook
    • 环境说明
    • 错误码
    • 码流转发
      • 码流转发流程图
      • 开始码流转发(Beta)
      • 关闭码流转发(Beta)
      • 获取码流转发频道转码器(Beta)
    • 任务下发
      • 获取项目航线文件列表
        GET
      • 创建任务
        POST
      • 航线任务执行中指令下发
        POST
      • 航线任务轨迹获取
        GET
      • 项目设备拓扑
        GET
      • 获取任务详情
        GET
    • 获取组织下的项目列表(Beta)
      GET
    • 获取指定项目的设备列表(Beta)
      GET
    • 发布通知及创建地图元素(Beta)
      POST
    • 获取项目临时上传凭证(Beta)
      POST
    • 航线上传通知(Beta)
      POST
    • 获取生成文件信息及下载地址(Beta)
      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
                    }
                ]
            }
        ]
    }
}
修改于 2025-01-07 10:21:19
上一页
航线任务轨迹获取
下一页
获取任务详情
Built with