API Evento

2026-10-16

Introduzione alle funzionalità

EventAPI è il servizio di notifica attiva di FlightHub Sync per l'invio di eventi aziendali a piattaforme di terze parti in tempo reale. Quando utilizzi EventAPI, tieni presente quanto segue:

    • Gli utenti devono verificare il campo x-dji-signature nell'intestazione del servizio ricevuto. La firma viene calcolata utilizzando HMAC-SHA256 sulla base del token dell'organizzazione, che viene utilizzato per verificare la validità dell'origine della richiesta.
  • Gli utenti possono configurare regole di notifica, selezionare i tipi di eventi a cui sottoscriversi e specificare la sottoscrizione dei dati per tutti i progetti o progetti specifici.
  • L'endpoint di ricezione supporta sia il protocollo HTTP sia quello HTTPS.
  • FlightHub 2 invierà le notifiche degli eventi utilizzando un indirizzo IP fisso. I server in regioni diverse utilizzano indirizzi IP diversi. Per la versione on-premises di FlightHub, l'indirizzo IP specifico dipende dal tuo server.
Paese/RegioneIP
Server UE + Server globale18.198.174.64
3.64.50.113
3.71.214.14
63.177.169.61
52.3.45.199
52.55.215.248
52.73.49.179
34.237.190.206
34.237.182.49
34.228.131.169

Configurazione delle regole di notifica

Gestione delle regole

L'elenco delle regole mostra le seguenti informazioni:

  • Nome della regola: definito dall'utente, fino a 60 caratteri
  • Indirizzo di invio: URL dell'endpoint (HTTP/HTTPS)
  • Ambito dei dati: tutti i progetti o progetti specifici
  • Eventi sottoscritti: elenco dei tipi di eventi selezionati
  • Stato: attivato/disattivato
  • Azioni: modifica, eliminazione

Configurazione dell'ambito dei dati

  • Tutti i progetti: include automaticamente tutti i progetti futuri.
  • Progetti specifici: ogni progetto può essere referenziato da una sola regola personalizzata (escluse le regole "Tutti i progetti"). I progetti già referenziati verranno disattivati.

Nota: se nell'organizzazione esiste già una regola "Tutti i progetti", la creazione di una nuova regola per progetti specifici attiverà un avviso di doppio invio degli eventi.

Audit dei log di consegna

EventAPI fornisce statistiche dei log di consegna di 7 giorni, inclusi:

  • Tasso di successo: mostrato come percentuale; un callback 200 è considerato riuscito.
  • Totale eventi: numero di eventi generati negli ultimi 7 giorni
  • Numero di errori: numero totale di consegne non riuscite in 7 giorni

I log degli ultimi 7 giorni possono essere scaricati in formato CSV. Vengono conservati solo i dati di questo periodo.

Tipi di eventi inviati

Notifica di sincronizzazione dei file

{
  "id": "e3b0c442-73fc-1c14-9afb-f17e2fa6826a", // Universally unique identifier (UUID) for event message
  "type": "file_sync_success", // Event type: file synced notification
  "created_at": 1767875288, // Event push timestamp (seconds)
  "data": {
    "task_id": "sync_task_10001", // Universally unique identifier of the sync task
    "organization_id": "org_123456_xxxxxx", // organization ID
    "project_id": "proj_789012_xxxxxx", // Project ID of file
    "file_id": "file_345678_xxxxxx", // File ID within FlightHub
    "file_type": "application/pdf", // File type (waypoint route, flight record, model, or media file)
    "file_external_key": "customer_storage/2026/01/report_09.pdf", // Object Key (storage path) for file in third-party storage bucket
    "file_bytes_size": 1048576, // File size (bytes)
    "fh2_file_path": "/project_docs/report/report_09.pdf", // Original logical path of the file in DJI FlightHub 2
   }
}

Ottenere l'elenco degli avvisi AI e lo snapshot

{
  "id": "e3b0c442-98fc-1c14-9afb-f17e2fa6826a" , // UUID of the event message
  "type": "ai_alert_record", // Event type: AI detection records
  "created_at": 1767875288, // Event push timestamp (seconds)
  "data": {
    "alert_uuid": "e3b0c442-98fc-1c14-9afb-f17e2fa6826a", // UUID of warning records
    "algorithm_source": 100002, // // Algorithm source ID Enumeration values are as follows:
                                   // 0: DJI official intelligent algorithm
                                   // 1: DJI visible light detection of people, vehicles, and boats
                                   // 2: DJI infrared detection of people, vehicles, and boats
                                   // 3: DJI infrared temperature detection
                                   // 255: AI-inside third-party algorithms on aircraft
                                   // 100001: AI-LINK third-party cloud algorithms
                                   // 100002: DJI multimodal object detection
    "drone_sn": "1581F6XXXXXX00A6XXXX", // Serial number of the aircraft performing task
    "file_id": 123456, // Associated original media file ID
    "file_url": "https://file-storage.djicdn.com/example/path/image.jpg?auth_key=xxxx", // Original image download link (contains authentication parameters)
    "flight_id": "f17e2fa6-826a-48c5-a89a-fffe4093xxxx", // Associated flight ID
    "gateway_sn": "6QCDL8XXXXXX02XXXX", // Associated dock/gateway device SN
    "interval_seconds": 0, // Alert interval or duration (seconds). Defaults to 0 for non-cloud algorithms
    "labels": [
      "lights"// Detected subject label/type
    ],
    "location": {
      "altitude": 80.5, // The altitude when the alert occurred (meters)
      "latitude": 22.123456, // The latitude when the alert occurred. For on-board algorithms, this is the GPS coordinate of the center of the camera view when the alert occurred. For cloud algorithms, this is the position of the aircraft.
      "longitude": 113.123456, // The longitude when the alert occurred. For on-board algorithms, this is the GPS coordinate of the center of the camera view when the alert occurred. For cloud algorithms, this is the position of the aircraft.
    },
    "project_id": "fe2400a5-5a74-4cb5-8374-548b7eaxxxxx", // Affiliated project UUID
    "task_name": "FlyToTask_Inspect_ZoneA", // Associated flight task name
    "thumbnail_url": "https://oss-cn-hangzhou.aliyuncs.com/example/thumbnail.jpeg?Expires=1767961676&Signature=xxxx", // Thumbnail download link (includes signature and expiration date)
    "timestamp": 1767875275677, // The timestamp when AI detection occurred (milliseconds)
  }
}

Notifica dell'avanzamento del flusso di lavoro attivato

Utilizzato per inviare l'avanzamento dell'esecuzione dei nodi del flusso di lavoro di invio automatico (flusso di lavoro di risposta a incidenti), consentendo ai sistemi di terze parti di sincronizzare lo stato delle attività, identificare gli stati terminali e i contrassegni di falso allarme in tempo reale.

{
  "event_type": "alert_workflow_progress",         // Event type: triggered workflow execution progress
  "event_id": "e3b0c442-73fc-1c14-9afb-f17e2fa6826a", // Unique event message ID (UUID)
  "org_id": "org_123456_xxxxxx",                   // Organization ID this event belongs to
  "project_id": "proj_789012_xxxxxx",              // Project ID this event belongs to (optional)
  "created_at": 1767875288,                        // Event push timestamp (seconds)
  "data": {
    "incident_id": "incident_2026062900001",       // Incident event ID
    "workflow_uuid": "wf_uuid_xxxxxxxxxxxx",       // Workflow UUID
    "drone_sn": "1581F5BKD2380030XXXXX",           // Operating aircraft serial number
    "node_type": "command_task",                   // Node type: command_task (FlyTo task) / device_actions (device actions)
    "status": 1,                                   // Current node status code, depends on node_type; enumerations below:
                                                   // node_type = "command_task" (FlyTo task node):
                                                   //   0: Pending     (non-terminal)
                                                   //   1: Executing   (non-terminal)
                                                   //   2: Successful  (terminal)
                                                   //   3: Manual intervention (terminal)
                                                   //   4: Execution failed   (terminal)
                                                   // node_type = "device_actions" (device action node):
                                                   //   0: Successful       (terminal)
                                                   //   1: Partially successful (terminal)
                                                   //   2: Failed           (terminal)
                                                   //   3: In progress      (non-terminal)
                                                   //   4: Manual intervention (terminal)
    "is_false_alarm": false,                       // Whether marked as false alarm (real value only returned in terminal state; non-terminal is fixed to false)
    "flight_id": "task_uuid_xxxxxxxxxxxx"          // UUID of the current execution_task
  }
}

Notifica del caricamento dei file multimediali

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "media_file_uploaded",
  "created_at": 1767875288,
  "data": {
    "organization_id": "org_123456_xxxxxx",
    "project_id": "proj_789012_xxxxxx",
    "file_id": "file_345678_xxxxxx",
    "file_name": "DJI_20260108_120000_0001.JPG",
    "file_type": "image/jpeg",
    "file_size": 10485760,
    "device_sn": "1581F6XXXXXX00A6XXXX",
    "flight_id": "f17e2fa6-826a-48c5-a89a-fffe4093xxxx"
  }
}

Notifica di caricamento e aggiornamento dei file delle rotte di volo

{
  "type": "wayline_file_uploaded",
  "org_id": "1024dd05-34ce-46b6-a872-cb32b8c98f64",
  "project_id": "38535b47-b972-4663-b1ce-5bd5a29224a4",
  "created_at": 1769414678,
  "data": {
    "id": "testcda7-c97d-4bf6-8f8f-b490b9b18401", // Flight route ID
    "name": "New waypoint route (2)",           // Flight route name
    "object_key": "1testd05-34ce-46b6-a872-cb32b8c98f64/test9b47-b972-4663-b1ce-5bd5test24a4/e5testb3-2cf8-49af-b49b-64test0032c7/New waypoint route (2).kmz", // Flight route object storage key
    "type": 5 // File type. 5 indicates the flight route
  }
}

Notifica del completamento della ricostruzione del modello

{
  "type": "model_post_reconstruction",
  "org_id": "105ddd05-34ce-46b6-a872-cb32b8c98f64",
  "project_id": "38559b47-b972-4663-b1ce-5bd5a29224a4",
  "created_at": 1769414678,
  "data": {
    "id": "2e12cda7-c97d-4bf6-8f8f-btest9b18401", // Model ID
    "name": "xx Model",                      // Model Name
    "object_key": "105ddd05-34ce-46b6-a872-cb32b8c98f64/38559b47-b972-4663-b1ce-5bd5a29224a4/etestbb3-2cf8-49af-b49b-64b1610032c7/Model", // Model Object Storage Key
    "type": 8//8: 2D model, 9: 3D model
  }
}

Notifica di uscita anomala dall'RTH

{
  "id": "9ab96be1-0231-4b2c-9892-2221188c323b",
  "type": "device_exit_return_home",
  "created_at": 1769400986,
  "data": {
    "action": 1,
    "event_type": "device_exit_return_home",
    "notify_type": "device_exit_return_home",
    "organization_uuid": "8test46f-2cd5-476b-9f33-415c98de11a5",
    "project_uuid": "8test9a5-d2ba-423d-a03e-e3b323c40810",
    "reason": null, // Reason for the abnormal RTH exit: "2": "Behavior tree initialization failed"; "3": "Surrounded by obstacles"; "4": "Triggered flight restriction"; "5": "Obstacle too close"; "6": "No GPS signal"; "7": "GPS and VIO position output flags are false"; "8": "Large position error between GPS and VIO fusion"
    "sn": "158TESTGD24BK0010114" // SN of the aircraft that undergoes the abnormal RTH exit
  }
}

Notifica di aggiunta/modifica delle annotazioni dell'organizzazione

{
  "created_at": 1772803375,
  "data": {
    "count": 1,
    "download_url": "/openapi/v0.1/map/data-sync/files/33711783-bf96-440d-baa2-0e71afa1d485/f7356cd3-53de-4318-955f-306cbcc60ca2/0",
    "format": "kml-gz",
    "geometry_types": [
      "polygon"
    ],
    "sync_id": "annotation-f7356cd3-53de-4318-955f-306cbcc60ca2",
    "sync_type": 0
  },
  "id": "5df19eca-65cf-4975-a942-09fdcfd7bdf9",
  "org_id": "105ddd05-34ce-46b6-a872-cb32b8c98f64",
  "project_id": "33711783-bf96-440d-baa2-0e71afa1d485",
  "type": "map_geo_elements_update"
}

Invio dell'aggiornamento dell'indirizzo RTSP

{
  "converter_name": "Example Converter",
  "converter_id": "29f4f54b-93af-4fd3-aed6-bd3d768082e9",
  "sn": "SN1234567890",
  "camera_index": "89-0-0",
  "device_callsign": "DRONE-01",
  "url": "rtsp://192.168.1.10:554/live/stream",
  "username": "rtsp_user",
  "password": "rtsp_password"
}

API FlightHub Mapping - Avanzamento della ricostruzione del modello

{
    "msg_type": "model_reconstruction_percent_change", // Message type, model_reconstruction_percent_change=Model reconstruction, model_zip_change=Model compression
    "resource_uuid": "7417bac3-00a4-4e07-b078-233c77e3fdf9",
    "model_uuid": "3d33643c-de0d-4070-b155-8cf791e662e2",
    "model_status": 14, // Reconstruction status, 9=Model compression, 12=Waiting for resources, 13=Failed to obtain resources, 14=Reconstruction in progress, 15=Reconstruction successful, 16=Reconstruction canceled
    "model_size": 37353992,
    "reconstruction_progress": 100, // Reconstruction progress, 0-100
    "error_code": 0, // Reconstruction error code
    "zip_status": 2, // Compression status, 1=Compression in progress, 2=Compression completed, 3=Failed to compress
    "zip_progress": 100, // Compression progress 0-100
    "zip_file_key": "https://test-file-storage.djicdn.com/5a6f9d4b-2a38-4b4b-86f9-3a678da0bf4a/open_reconstruction/7417bac3-00a4-4e07-b078-233c77e3fdf9/3D/3d33643c-de0d-4070-b155-8cf791e662e2.zip?auth_key=1767942603-0-0-150d3c28868e91dd2446aef97c26de85", // Download address of compressed output file
}
Last Updated: