Introduzione alle API

DJI FlightHub 2 OpenAPI è una piattaforma aperta basata sulle specifiche RESTful, progettata per offrire agli sviluppatori la possibilità di interagire con le piattaforme cloud di terze parti e DJI FlightHub 2.

Ecco alcune funzionalità chiave di OpenAPI:

• Progettazione RESTful: adotta specifiche RESTful, rendendo l'uso dell'API più intuitivo e conforme agli standard web. Gli sviluppatori possono interagire con FlightHub 2 utilizzando metodi HTTP standard come GET, POST, PUT e DELETE.
• Autenticazione e autorizzazione: implementa meccanismi sicuri di autenticazione e autorizzazione per proteggere le risorse API e gestire efficacemente le autorizzazioni di accesso.
• Interazione con FlightHub 2: offre funzionalità come la gestione di organizzazioni e progetti di DJI FlightHub 2, la gestione dei dispositivi, la gestione del livestream, la gestione delle rotte di volo, la gestione delle attività, la gestione dei modelli e la gestione delle annotazioni.
• Supporto per sviluppatori e documentazione: offre documentazione API dettagliata, esempi di codice e supporto per gli sviluppatori, consentendo un'integrazione rapida e un utilizzo efficace delle funzionalità della piattaforma.

Gli sviluppatori possono integrare rapidamente le funzionalità principali di FlightHub 2 chiamando OpenAPI, riducendo significativamente i costi di sviluppo e soddisfacendo varie esigenze aziendali e scenari applicativi innovativi.

Architettura del prodotto

Guida rapida

Configurazione dell'ambiente

Fai riferimento al Manuale di distribuzione della versione On-Premises di DJI FlightHub 2 per distribuire la versione on-premises di FlightHub 2.

Autenticazione e autorizzazione

Fai riferimento al tutorial Autenticazione e autorizzazione per comprendere i principi di autenticazione e autorizzazione di OpenAPI, ottenere i valori di X-User-Token e X-Project-Uuid e inserire questi due valori nel campo dell'intestazione per garantire la sicurezza di OpenAPI e realizzare il controllo degli accessi a FlightHub 2.

Codice di esempio

1. Query dello stato del sistema FlightHub 2

La versione pubblica di FlightHub 2 utilizza l'API per interrogare lo stato del sistema: Query dello stato del sistema FlightHub 2

Dopo che la versione on-premises di FlightHub 2 è stata distribuita con successo, chiama il metodo per verificare lo stato del sistema: Query dello stato del sistema 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 

Un valore di ritorno pari a 0 indica che il sistema FlightHub 2 funziona normalmente.

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

2. Ottenere l'elenco dei progetti dell'organizzazione

Crea un'organizzazione, configura un progetto e associa i dispositivi in FlightHub 2. Fai riferimento alla sezione Manuale utente DJI FlightHub 2 > Gestione dell'organizzazione per creare organizzazioni e progetti in FlightHub 2, quindi chiama il metodo Ottieni l'elenco dei progetti dell'organizzazione per ottenere l'elenco dei progetti creati.

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

Verrà restituito l'elenco dei progetti creati.

```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. Avviare il livestream

Fai riferimento alla sezione Manuale utente DJI FlightHub 2 > Gestione dei dispositivi per associare i dispositivi in FlightHub 2, quindi fai riferimento al tutorial Gestione del livestream e chiama il metodo Abilita livestream per avviare lo streaming.

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

Il link del livestream sarà disponibile su data.url, dove puoi visitarlo per visualizzare il livestream.

```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 delle interfacce

• Il tutorial delle interfacce include l'elenco delle funzionalità OpenAPI, tutorial, elenco dei metodi e descrizioni. Fai riferimento al Tutorial delle interfacce OpenAPI per maggiori dettagli.