Public Cloud V2.0

2026-09-22

Wprowadzenie API

Public Cloud OpenAPI V2.0 to otwarta platforma oparta na specyfikacjach RESTful, zaprojektowana w celu zapewnienia programistom interoperacyjności danych i integracji biznesowej między platformami chmurowymi innych firm a Public Cloud DJI FlightHub 2.

Za pośrednictwem OpenAPI V2.0 programiści mogą tworzyć integracje systemowe wokół organizacji i członków, urządzeń, zadań lotu, transmisji na żywo i innych danych, aby zasilać przypadki użycia, takie jak nadzór nad urządzeniami, nadzór nad zadaniami i aplikacje transmisji na żywo.

W porównaniu z V1.0, V2.0 dodaje więcej interfejsów zapytań i scenariuszy biznesowych oprócz istniejących funkcji. Przebudowuje również system interfejsów, oddzielając dokumentację interfejsów Public Cloud i On-Premises, co czyni kategoryzację wyraźniejszą dla szybszego wdrożenia i integracji programistów oraz umożliwia bardziej elastyczną iterację OpenAPI w przyszłości.

Lista funkcji

FunkcjaOpis
Zapytania o informacje organizacji, projektu i członkówZapewnia możliwości zapytań o listę organizacji, listę projektów, listę użytkowników, listę uprawnień, uprawnienia ról i więcej.
Zapytanie o informacje o urządzeniuPobiera listy urządzeń w organizacjach lub projektach, szczegóły urządzeń projektu, historyczną topologię urządzeń, informacje HMS, informacje o modelu rzeczy (thing-model), ostrość strumienia wideo i więcej — do zarządzania zasobami urządzeń i wyświetlania statusu.
Zadania lotuObsługuje tworzenie zadań lotu, zapytania o listy zadań, szczegóły zadań, trajektorie lotu, zasoby multimedialne, pobieranie rekordów lotu, logi operacji, alerty lotu AI i więcej.
Sterowanie w czasie rzeczywistymObsługuje zapytania o status uprawnień sterowania urządzeniami, uzyskiwanie uprawnień sterowania, przełączanie kamer i więcej.
Transmisja na żywo i przekazywanieObsługuje uruchamianie transmisji na żywo, zapytania o zadania nagrywania oraz tworzenie, zapytania i usuwanie konwerterów strumienia.
Zapytanie o trasy lotuObsługuje pobieranie listy tras lotu w projekcie, uzyskiwanie szczegółów tras lotu i więcej.
Rekonstrukcja modeliObsługuje uruchamianie zadań rekonstrukcji przy użyciu danych multimedialnych zebranych z zadań lotu FlightHub.
Otwarte modelowanieObsługuje uruchamianie zadań rekonstrukcji przy użyciu danych multimedialnych z chmur innych firm.

Dokumentacja interfejsów

Przykładowy kod źródłowy

Po wdrożeniu i pomyślnym uruchomieniu przykładowego kodu źródłowego możesz doświadczyć interfejsu funkcji opracowanego na bazie OpenAPI V2.0. Przykładowy kod źródłowy pomaga również szybko zrozumieć, jak uzyskać dostęp do OpenAPI i z niej korzystać, przyspieszając rozwój i integrację.

Kliknij Przykładowy kod źródłowy, aby uzyskać kod źródłowy i przewodnik dostępu.

Architektura produktu

Szybki start

Uwierzytelnianie i autoryzacja

Zapoznaj się z dokumentem Tutorial uwierzytelniania i autoryzacji, aby zrozumieć zasady uwierzytelniania i autoryzacji OpenAPI oraz uzyskać X-User-Token i X-Project-Uuid. Te dwa parametry muszą być przekazywane w polu nagłówka większości interfejsów, aby zapewnić bezpieczeństwo OpenAPI i wdrożyć kontrolę dostępu do FlightHub 2.

Przykładowy kod

1. Zapytanie o status systemu FlightHub 2

Public Cloud FlightHub 2 wywołuje interfejs, aby zapytać o status systemu: Zapytanie o status systemu FlightHub 2

```http
GET /openapi/v2.0/system_status HTTP/1.1
Host: 127.0.0.1:30812
X-Language: en
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
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ą "Podstawy platformy > Zarządzanie organizacją" tego podręcznika dotyczącą tworzenia organizacji i projektów w FlightHub 2, a następnie wywołaj interfejs Uzyskaj listę projektów organizacji, aby uzyskać listę utworzonych projektów.

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: en
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
X-User-Token: xxxxxxxx

Zostanie zwrócona lista utworzonych projektów:

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

Zapoznaj się z sekcją Zarządzanie urządzeniami tego podręcznika, aby powiązać urządzenia w FlightHub 2, a następnie zapoznaj się z Tutorialem zarządzania transmisją na żywo i wywołaj interfejs Uruchom transmisję na żywo, aby rozpocząć przesyłanie strumienia.

```http 
POST /openapi/v2.0/live-stream/start HTTP/1.1
Host: 127.0.0.1:30812
X-Project-Uuid: xxxxxxxxxx
X-Language: en
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"
}

Zwraca informacje o autoryzacji transmisji na żywo w data.url. Strumień należy pobrać przy użyciu SDK odpowiedniego dostawcy wskazanego przez data.url_type:

```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: