Wprowadzenie API

DJI FlightHub 2 OpenAPI to otwarta platforma oparta na specyfikacjach RESTful, zaprojektowana w celu zapewnienia programistom możliwości interakcji z platformami chmurowymi innych firm i DJI FlightHub 2.

Oto niektóre kluczowe funkcje OpenAPI:

• Projekt RESTful: przyjmuje specyfikacje RESTful, czyniąc korzystanie z API bardziej intuicyjnym i zgodnym ze standardami internetowymi. Programiści mogą wchodzić w interakcje z FlightHub 2 przy użyciu standardowych metod HTTP, takich jak GET, POST, PUT i DELETE.
• Uwierzytelnianie i autoryzacja: wdraża bezpieczne mechanizmy uwierzytelniania i autoryzacji, aby chronić zasoby API i skutecznie zarządzać uprawnieniami dostępu.
• Interakcja z FlightHub 2: oferuje funkcje takie jak zarządzanie organizacjami i projektami DJI FlightHub 2, zarządzanie urządzeniami, zarządzanie transmisją na żywo, zarządzanie trasami lotu, zarządzanie zadaniami, zarządzanie modelami i zarządzanie adnotacjami.
• Wsparcie dla programistów i dokumentacja: oferuje szczegółową dokumentację API, przykłady kodu i wsparcie dla programistów, umożliwiając szybką integrację i efektywne wykorzystanie funkcji platformy.

Programiści mogą szybko zintegrować podstawowe funkcje FlightHub 2, wywołując OpenAPI, znacznie obniżając koszty rozwoju i zaspokajając różne potrzeby biznesowe oraz innowacyjne scenariusze aplikacji.

Architektura produktu

Szybki start

Konfiguracja środowiska

Zapoznaj się z Podręcznikiem wdrożenia wersji on-premises DJI FlightHub 2, aby wdrożyć wersję on-premises FlightHub 2.

Uwierzytelnianie i autoryzacja

Zapoznaj się z tutorialem Uwierzytelnianie i autoryzacja, aby zrozumieć zasady uwierzytelniania i autoryzacji OpenAPI, uzyskać wartości X-User-Token i X-Project-Uuid oraz wprowadzić te dwie wartości w polu nagłówka, aby zapewnić bezpieczeństwo OpenAPI i osiągnąć kontrolę dostępu do FlightHub 2.

Przykładowy kod

1. Zapytanie o status systemu FlightHub 2

Wersja publiczna FlightHub 2 używa API do zapytania o status systemu: Zapytanie o status systemu FlightHub 2

Po pomyślnym wdrożeniu wersji on-premises FlightHub 2 wywołaj metodę, aby sprawdzić status systemu: Zapytanie o status systemu FlightHub 2

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

Wartość zwrotna 0 oznacza, że system FlightHub 2 działa normalnie.

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

2. Uzyskanie listy projektów organizacji

Utwórz organizację, skonfiguruj projekt i powiąż urządzenia w FlightHub 2. Zapoznaj się z sekcją Podręcznik użytkownika DJI FlightHub 2 > Zarządzanie organizacją dotyczącą tworzenia organizacji i projektów w FlightHub 2, a następnie wywołaj metodę Uzyskaj listę projektów organizacji, aby uzyskać listę utworzonych projektów.

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

Zostanie zwrócona lista utworzonych projektów.

```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. Uruchomienie transmisji na żywo

Zapoznaj się z sekcją Podręcznik użytkownika DJI FlightHub 2 > Zarządzanie urządzeniami dotyczącą wiązania urządzeń w FlightHub 2, a następnie zapoznaj się z tutorialem Zarządzanie transmisją na żywo i wywołaj metodę Włącz transmisję na żywo, aby rozpocząć przesyłanie strumienia.

```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"
}

Link do transmisji na żywo będzie dostępny pod data.url, gdzie możesz go odwiedzić, aby obejrzeć transmisję na żywo.

```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.eyJwcm9kdWN0X2lkIjoiNzEzNTE5ZmIxYjRlNDRiYTlkMjdkMDJhOGRlZDk5NGQiLCJjaGFubmVsX25hbWUiOiI3Q1RETTNEMDBCWk5WWl8xNjUtMC03IiwidWlkIjoxDAxMTQsImFjdGlvbiI6InBsYiIsImV4cCI6MTc2NDc1MTYzMCwibmJmIjoxNzMzMjE1NjMwLCJpYXQiOjE3MzMyMTU2MzB9._AysitutpprlgYGFy4lDL_gSv4Y3hl_te-yxoFVHZb4",
    "url_type": "srs"
  }
}

Tutorial interfejsów

• Tutorial interfejsów obejmuje listę funkcji OpenAPI, tutoriale, listę metod i opisy. Szczegóły znajdziesz w Tutorialu interfejsów OpenAPI.