Public Cloud V2.0

2026-09-20

API-Einführung

Public Cloud OpenAPI V2.0 ist eine offene Plattform basierend auf RESTful-Spezifikationen und wurde entwickelt, um Entwicklern die Datenanbindung und Geschäftsintegration zwischen Cloud-Plattformen von Drittanbietern und der FlightHub 2 Public Cloud zu ermöglichen.

Über OpenAPI V2.0 können Entwickler Systemintegrationen rund um Daten zu Organisationen und Mitgliedern, Geräten, Flugaufgaben, Livestreams usw. realisieren und Geschäftsanwendungen wie Geräteüberwachung, Aufgabenüberwachung und Livestream-Anwendungen aufbauen.

Im Vergleich zu V1.0 ergänzt V2.0 die bestehenden Funktionen um zusätzliche Abfrage- und Geschäftsszenario-Schnittstellen. Gleichzeitig wurde in dieser Version das Schnittstellensystem optimiert, indem die Dokumentation für Public Cloud und On-Premises voneinander getrennt wurde. Dadurch wird die Kategorisierung der Schnittstellen klarer, was Entwicklern ein schnelleres Verständnis und eine einfachere Integration ermöglicht und gleichzeitig eine agilere Iterationsweise von OpenAPI in der Zukunft erleichtert.

Funktionsliste

FunktionBeschreibung
Abfrage von Organisations-, Projekt- und MitgliederinformationenBietet Abfragefunktionen für Organisationslisten, Projektlisten, Benutzerlisten, Berechtigungslisten, Rollenberechtigungen und mehr.
Abfrage von GeräteinformationenRuft Gerätelisten unter Organisationen oder Projekten, Gerätedetails von Projekten, Geräteverlaufstopologie, HMS-Informationen, Thing-Model-Informationen, Bildübertragungsqualität und mehr ab – zur Verwaltung von Geräte-Assets und zur Statusanzeige.
FlugaufgabenUnterstützt das Erstellen von Flugaufgaben, das Abfragen von Aufgabenlisten, Aufgabendetails, Flugbahnen, Medienressourcen, das Herunterladen von Flugaufzeichnungen, Bedienprotokollen, AI-Flugwarnungen und mehr.
EchtzeitsteuerungUnterstützt das Abfragen des Gerätesteuerungsrechts, das Erlangen der Steuerungsberechtigung, das Umschalten der Kamera und mehr.
Livestream und WeiterleitungUnterstützt das Starten von Livestreams, das Abfragen von Aufzeichnungsaufgaben sowie das Erstellen, Abfragen und Löschen von Stream-Weiterleitern.
FlugroutenabfrageUnterstützt das Abrufen der Flugroutenliste eines Projekts, das Abrufen von Flugroutendetails und mehr.
ModellrekonstruktionUnterstützt das Starten von Modellierungsaufgaben mit Mediendaten, die von FlightHub-Flugaufgaben erfasst wurden.
Offene ModellierungUnterstützt das Starten von Modellierungsaufgaben mit Mediendaten aus Cloud-Plattformen von Drittanbietern.

Schnittstellendokumentation

  • Die Schnittstellendokumentation umfasst die OpenAPI-Funktionsliste, Tutorials, Schnittstellenliste und Schnittstellenbeschreibungen. Weitere Details finden Sie unter: Open API Schnittstellendokumentation.

Beispielquellcode

Nachdem Sie den Beispielquellcode bereitgestellt und erfolgreich ausgeführt haben, können Sie die auf OpenAPI V2.0 basierende Funktionsoberfläche erleben. Anhand des Beispielquellcodes können Sie sich außerdem schnell mit der Anbindung und Verwendung der OpenAPI vertraut machen und so die Entwicklung und Integration beschleunigen.

Klicken Sie auf Beispielquellcode, um den Quellcode und die Anbindungsanleitung zu erhalten.

Produktarchitektur

Schnellstart

Authentifizierung und Autorisierung

Beziehen Sie sich auf das Dokument Tutorial zur Authentifizierung und Autorisierung, um die Prinzipien der OpenAPI-Authentifizierung und -Autorisierung zu verstehen und X-User-Token und X-Project-Uuid zu erhalten. Diese beiden Parameter müssen im Header-Feld der meisten Schnittstellen übergeben werden, um die Sicherheit von OpenAPI zu gewährleisten und die Zugriffskontrolle auf FlightHub 2 zu realisieren.

Beispielcode

1. FlightHub 2-Systemstatus abfragen

FlightHub 2 Public Cloud ruft die Schnittstelle auf, um den Systemstatus abzufragen: FlightHub 2-Systemstatus abfragen

```http
GET /openapi/v2.0/system_status HTTP/1.1
Host: 127.0.0.1:30812
X-Language: zh
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
X-User-Token: xxxxxxxx

Ein Rückgabewert von 0 zeigt an, dass das FlightHub 2-System normal funktioniert:

```http 
{
  "code": 0,
  "message": ""
}

2. Liste der Projekte unter der Organisation abrufen

Erstellen Sie eine Organisation, ein Projekt und binden Sie Geräte in FlightHub 2 ein. Beziehen Sie sich auf den Abschnitt Plattformgrundlagen > Organisationsverwaltung dieses Handbuchs zur Erstellung von Organisationen und Projekten in FlightHub 2, und rufen Sie anschließend die Schnittstelle Liste der Projekte unter der Organisation abrufen auf, um die Liste der erstellten Projekte zu erhalten.

GET /openapi/v2.0/project?usage=complete&sort_column=create_time&sort_type=desc&page=1&page_size=20 HTTP/1.1
Host: 127.0.0.1:30812
X-Language: zh
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
X-User-Token: xxxxxxxx

Die Liste der erstellten Projekte wird zurückgegeben:

```http 
{
  "code": 0,
  "message": "",
  "data": {
    "list": [
      {
        "name": "c2c_test",
        "introduction": "a",
        "uuid": "93df839d-ae74-4f04-842e-2f1f81c89a66",
        "org_uuid": "105ddd05-34ce-46b6-a872-cb32b8c98f64",
        "created_at": 1702498686,
        "updated_at": 1702498686,
        "project_work_center_point": {
          "latitude": 22.906899500237845,
          "longitude": 113.69995967214662
        }
      }
    ]
  }
}

3. Livestream-Funktion starten

Beziehen Sie sich auf das Kapitel Geräteverwaltung dieses Handbuchs zur Gerätebindung in FlightHub 2, beziehen Sie sich anschließend auf das Livestream-Verwaltungs-Tutorial und rufen Sie die Schnittstelle Livestream starten auf, um das Streaming zu starten.

```http 
POST /openapi/v2.0/live-stream/start HTTP/1.1
Host: 127.0.0.1:30812
X-Project-Uuid: xxxxxxxxxx
X-Language: zh
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
Content-Type: application/json
X-User-Token:  xxxxxxxx 
Content-Length: 119

{
    "sn": "7CTDM3Dxxxxxx",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "quality_type": "adaptive"
}

Gibt die Livestream-Autorisierungsinformationen zurück: data.url muss in Kombination mit dem SDK des entsprechenden Anbieters, der durch data.url_type angegeben wird, verwendet werden, um den Livestream abzurufen:

```c
{
  "code": 0,
  "message": "",
  "data": {
    "expire_ts": 1779446430,
    "url": "http://127.0.0.1:30806/rtc/v1/whep/?app=live&stream=7CTDM3Dxxxxxx_165-0-7&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwcm9kdWN0X2lkIjoiNzEzNTE5ZmIxYjRlNDRiYTlkMjdkMDJhOGRlZDk5NGQiLCJjaGFubmVsX25hbWUiOiI3Q1RETTNEMDBCWk5WWl8xNjUtMC03IiwidWlkIjoxDAxMTQsImFjdGlvbiI6InBsYiLCJleHAiOjE3NjQ3NTE2MzAsIm5iZiI6MTczMzIxNTYzMCwiaWF0IjoxNzMzMjE1NjMwfQ._AysitutpprlgYGFy4lDL_gSv4Y3hl_te-yxoFVHZb4",
    "url_type": "srs"
  }
}
Last Updated: