API-Einführung

DJI FlightHub 2 OpenAPI ist eine offene Plattform, basierend auf RESTful-Spezifikationen, die entwickelt wurde, um Entwicklern die Möglichkeit zu geben, mit Cloud-Plattformen von Drittanbietern und DJI FlightHub 2 zu interagieren.

Hier sind einige Hauptmerkmale von OpenAPI:

• RESTful-Design: Verwendet RESTful-Spezifikationen, wodurch die Nutzung der API intuitiver wird und den Webstandards entspricht. Entwickler können mit FlightHub 2 unter Verwendung von standardmäßigen HTTP-Methoden wie GET, POST, PUT und DELETE interagieren.
• Authentifizierung und Autorisierung: Implementiert sichere Authentifizierungs- und Autorisierungsmechanismen, um API-Ressourcen zu schützen und Zugriffsrechte effektiv zu verwalten.
• FlightHub 2-Interaktion: Bietet Funktionen wie DJI FlightHub 2 Organisations- und Projektmanagement, Geräteverwaltung, Livestream-Verwaltung, Flugroutenverwaltung, Aufgabenverwaltung, Modellverwaltung und Anmerkungsverwaltung.
• Entwickler-Support und Dokumentation: Bietet detaillierte API-Dokumentation, Codebeispiele und Entwickler-Support, was eine schnelle Integration und eine effektive Nutzung der Plattformfunktionen ermöglicht.

Entwickler können die Kernfunktionen von FlightHub 2 durch den Aufruf von OpenAPI schnell integrieren, wodurch die Entwicklungskosten erheblich gesenkt und verschiedene Geschäftsanforderungen sowie innovative Anwendungsszenarien realisiert werden können.

Produktarchitektur

Schnellstart

Umgebungseinrichtung

Beachten Sie das Bereitstellungshandbuch der DJI FlightHub 2 On-Premises Version, um die lokale Version von FlightHub 2 bereitzustellen.

Authentifizierung und Autorisierung

Beziehen Sie sich auf das Tutorial zur Authentication and Authorization, um die Prinzipien der OpenAPI-Authentifizierung und -Autorisierung zu verstehen, die Werte von X-User-Token und X-Project-Uuid zu erhalten und diese beiden Werte in das Header-Feld einzugeben, um die Sicherheit von OpenAPI zu gewährleisten und den Zugriff auf FlightHub 2 zu steuern.

Beispielcode

1. FlightHub 2 Systemstatus abfragen

Die Öffentliche Version von FlightHub 2 ruft die Systemstatus-API ab: Query FlightHub 2 System Status

Nachdem die lokale Version von FlightHub 2 erfolgreich bereitgestellt wurde, rufen Sie die Methode Query FlightHub 2 System Status auf, um den Systemstatus zu überprüfen.

```http
GET /openapi/v0.1/system_status HTTP/1.1
Host: 127.0.0.1:30812
X-Language: en
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, richten Sie ein Projekt ein und binden Sie Geräte in FlightHub 2. Beziehen Sie sich auf das DJI FlightHub 2 Benutzerhandbuch > OrganisationsverwaltungAbschnitt zum Erstellen von Organisationen und Projekten in FlightHub 2, rufen Sie dann die Methode Get the List of Projects under the Organizationauf, um die Liste der erstellten Projekte zu erhalten.

```http
GET /openapi/v0.1/project HTTP/1.1
Host: 127.0.0.1:30812
X-Language: en
X-User-Token: xxxxxxxx

Die Liste der erstellten Projekte wird zurückgegeben.

```http
{
  "code": 0,
  "message": "OK",
  "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 starten

Beziehen Sie sich auf das DJI FlightHub 2 Benutzerhandbuch > Geräteverwaltung Abschnitt zum Binden von Geräten in FlightHub 2, beziehen Sie sich dann auf das Tutorial zur Livestream Management und rufen Sie die Methode Enable Livestream auf, um das Streaming zu starten.

```http
POST /openapi/v0.1/live-stream/start HTTP/1.1
Host: 127.0.0.1:30812
X-Project-Uuid: xxxxxxxxxx
X-Language: en
Content-Type: application/json
X-User-Token:  xxxxxxxx
Content-Length: 120
{
    "sn": "7CTDM3Dxxxxxx",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "video_quality": "adaptive"
}

Der Livestream-Link ist unter data.url verfügbar, wo Sie den Livestream ansehen können.

```c
{
  "code": 0,
  "message": "",
  "data": {
    "expire_ts": 1764751629,
    "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"
  }
}

Schnittstellen-Tutorial

• Das Schnittstellen-Tutorial enthält die OpenAPI-Funktionsliste, Tutorials, Methodenliste und Beschreibungen. Beziehen Sie sich für weitere Details auf das OpenAPI Interface Tutorial.