기능 소개

EventAPI는 비즈니스 이벤트를 실시간으로 타사 플랫폼으로 푸시하기 위한 FlightHub Sync의 능동 알림 서비스입니다. EventAPI를 사용할 때는 다음 사항에 유의하십시오.

• • 사용자는 수신한 서비스의 헤더에 있는 ‘x-dji-signature’ 필드를 검증해야 합니다. 서명은 요청 소스의 유효성을 검증하는 데 사용되는 조직 토큰을 기반으로 HMAC-SHA256을 사용하여 계산됩니다.
• 사용자는 알림 규칙을 구성하고, 구독할 이벤트 유형을 선택하며, 모든 프로젝트 또는 특정 프로젝트에 대한 데이터 구독을 지정할 수 있습니다.
• 수신 엔드포인트는 HTTP 및 HTTPS 프로토콜을 모두 지원합니다.
• FlightHub 2는 고정 IP 주소를 사용하여 이벤트 알림을 푸시합니다. 서버는 지역마다 서로 다른 IP 주소를 사용합니다. 온프레미스 버전의 FlightHub의 경우, 사용 중인 서버에 따라 특정 IP 주소가 달라집니다.

국가/지역	IP
EU 서버 + 글로벌 서버	18.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

알림 규칙 구성

규칙 관리

규칙 목록에는 다음 정보가 표시됩니다.

• 규칙 이름: 사용자 정의, 최대 60자
• 푸시 주소: 엔드포인트 URL(HTTP/HTTPS)
• 데이터 범위: 모든 프로젝트 또는 특정 프로젝트
• 구독된 이벤트: 선택된 이벤트 유형 목록
• 상태: 활성화됨/비활성화됨
• 작업: 편집, 삭제

데이터 범위 구성

• 전체 프로젝트: 향후 생성되는 모든 프로젝트를 자동으로 포함합니다.
• 특정 프로젝트: 각 프로젝트는 하나의 사용자 정의 규칙에서만 참조될 수 있음(‘전체 프로젝트’ 규칙 제외). 이미 참조된 프로젝트는 회색으로 표시됩니다.

유의 사항: 조직에 이미 "전체 프로젝트" 규칙이 있는 경우, 새로운 특정 프로젝트 규칙을 생성하면 이중 이벤트 푸시 경고가 트리거됩니다.

전송 로그 감사

EventAPI는 7일간의 전송 로그 통계를 제공하며, 여기에는 다음이 포함됩니다.

• 성공률: 백분율로 표시되며, 200 콜백은 성공으로 간주됩니다.
• 전체 이벤트: 지난 7일 동안 생성된 이벤트 수
• 실패 횟수: 7일간 실패한 전송의 총수

최근 7일간의 로그는 CSV 형식으로 다운로드할 수 있습니다. 이 기간의 데이터만 보관됩니다.

푸시 조정 이벤트 유형

파일 동기화 알림

{
  "id": "e3b0c442-73fc-1c14-9afb-f17e2fa6826a", // 이벤트 메시지의 범용 고유 식별자(UUID)
  "type": "file_sync_success", // 이벤트 유형: 파일 동기화 알림
  "created_at": 1767875288, // 이벤트 푸시 타임스탬프(초)
  "data": {
    "task_id": "sync_task_10001", // 동기화 작업의 범용 고유 식별자
    "organization_id": "org_123456_xxxxxx", // 조직 ID
    "project_id": "proj_789012_xxxxxx", // 파일의 프로젝트 ID
    "file_id": "file_345678_xxxxxx", // FlightHub 내의 파일 ID
    "file_type": "application/pdf", // 파일 유형(웨이포인트 경로, 비행 기록, 모델 또는 미디어 파일)
    "file_external_key": "customer_storage/2026/01/report_09.pdf", // 서드파티 스토리지 버킷에 있는 파일의 오브젝트 키(저장 경로)
    "file_bytes_size": 1048576, // 파일 크기(바이트)
    "fh2_file_path": "/project_docs/report/report_09.pdf", // DJI FlightHub 2에서 파일의 원래 논리 경로
   }
}

AI 경고 목록 및 스냅샷 가져오기

{
  "id": "e3b0c442-98fc-1c14-9afb-f17e2fa6826a" , // 이벤트 메시지의 UUID
  "type": "ai_alert_record", // 이벤트 유형: AI 감지 기록
  "created_at": 1767875288, // 이벤트 푸시 타임스탬프(초)
  "data": {
    "alert_uuid": "e3b0c442-98fc-1c14-9afb-f17e2fa6826a", // 경고 기록의 UUID
    "algorithm_source": 100002, // // 알고리즘 소스 ID. 열거값은 다음과 같습니다:
                                   // 0: DJI 공식 인텔리전트 알고리즘
                                   // 1: DJI 가시광선 사람, 차량, 선박 감지
                                   // 2: DJI 적외선 사람, 차량, 선박 감지
                                   // 3: DJI 적외선 온도 감지
                                   // 255: 기체 탑재 AI-inside 서드파티 알고리즘
                                   // 100001: AI-LINK 서드파티 클라우드 알고리즘
                                   // 100002: DJI 멀티모달 객체 감지
    "drone_sn": "1581F6XXXXXX00A6XXXX", // 작업을 수행하는 기체의 일련번호
    "file_id": 123456, // 연관된 원본 미디어 파일 ID
    "file_url": "https://file-storage.djicdn.com/example/path/image.jpg?auth_key=xxxx", // 원본 이미지 다운로드 링크(인증 매개변수 포함)
    "flight_id": "f17e2fa6-826a-48c5-a89a-fffe4093xxxx", // 연관된 비행 ID
    "gateway_sn": "6QCDL8XXXXXX02XXXX", // 연관된 독/게이트웨이 장치 SN
    "interval_seconds": 0, // 경고 간격 또는 지속 시간(초). 비클라우드 알고리즘의 경우 기본값은 0
    "labels": [
      "lights"// 감지된 대상 라벨/유형
    ],
    "location": {
      "altitude": 80.5, // 경고 발생 시의 고도(미터)
      "latitude": 22.123456, // 경고 발생 시의 위도. 탑재 알고리즘의 경우, 경고 발생 시 카메라 시야 중심의 GPS 좌표입니다. 클라우드 알고리즘의 경우, 기체의 위치입니다.
      "longitude": 113.123456, // 경고 발생 시의 경도. 탑재 알고리즘의 경우, 경고 발생 시 카메라 시야 중심의 GPS 좌표입니다. 클라우드 알고리즘의 경우, 기체의 위치입니다.
    },
    "project_id": "fe2400a5-5a74-4cb5-8374-548b7eaxxxxx", // 소속 프로젝트 UUID
    "task_name": "FlyToTask_Inspect_ZoneA", // 연관된 비행 작업 이름
    "thumbnail_url": "https://oss-cn-hangzhou.aliyuncs.com/example/thumbnail.jpeg?Expires=1767961676&Signature=xxxx", // 썸네일 다운로드 링크(서명 및 만료일 포함)
    "timestamp": 1767875275677, // AI 감지가 발생한 타임스탬프(밀리초)
  }
}

트리거형 워크플로 실행 진행 알림

자동 디스패치 워크플로(접처경 워크플로)의 노드 실행 진행 상황을 푸시하는 데 사용되며, 제3자 시스템이 작업 상태, 종료 상태, 오경보 표시를 실시간으로 동기화할 수 있도록 합니다.

{
  "event_type": "alert_workflow_progress",         // 이벤트 유형: 트리거형 워크플로 실행 진행
  "event_id": "e3b0c442-73fc-1c14-9afb-f17e2fa6826a", // 이벤트 메시지의 고유 식별 ID (UUID)
  "org_id": "org_123456_xxxxxx",                   // 이 이벤트가 속한 조직 ID
  "project_id": "proj_789012_xxxxxx",              // 이 이벤트가 속한 프로젝트 ID (선택)
  "created_at": 1767875288,                        // 이벤트 푸시 타임스탬프 (초)
  "data": {
    "incident_id": "incident_2026062900001",       // 경고 이벤트 ID
    "workflow_uuid": "wf_uuid_xxxxxxxxxxxx",       // 워크플로 UUID
    "drone_sn": "1581F5BKD2380030XXXXX",           // 운영 기체 일련 번호
    "node_type": "command_task",                   // 노드 유형: command_task(FlyTo 임무) / device_actions(기기 동작)
    "status": 1,                                   // 현재 노드 상태 코드, node_type에 따라 다름. 아래 열거 참조:
                                                   // node_type = "command_task"(FlyTo 임무 노드):
                                                   //   0: 대기 중   (비종료)
                                                   //   1: 실행 중   (비종료)
                                                   //   2: 성공      (종료)
                                                   //   3: 수동 개입 (종료)
                                                   //   4: 실행 실패 (종료)
                                                   // node_type = "device_actions"(기기 동작 노드):
                                                   //   0: 성공      (종료)
                                                   //   1: 부분 성공 (종료)
                                                   //   2: 실패      (종료)
                                                   //   3: 진행 중   (비종료)
                                                   //   4: 수동 개입 (종료)
    "is_false_alarm": false,                       // 오경보 표시 여부 (종료 상태에서만 실제 값 반환; 비종료는 항상 false 고정)
    "flight_id": "task_uuid_xxxxxxxxxxxx"          // 현재 execution_task의 UUID
  }
}

미디어 파일 업로드 알림

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

비행경로 파일 업로드 및 업데이트 알림

{
  "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", // 비행 경로 ID
    "name": "New waypoint route (2)",           // 비행 경로 이름
    "object_key": "1testd05-34ce-46b6-a872-cb32b8c98f64/test9b47-b972-4663-b1ce-5bd5test24a4/e5testb3-2cf8-49af-b49b-64test0032c7/New waypoint route (2).kmz", // 비행 경로 오브젝트 스토리지 키
    "type": 5 // 파일 유형. 5는 비행 경로를 나타냄
  }
}

모델 재구성 완료 알림

{
  "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", // 모델 ID
    "name": "xx Model",                      // 모델 이름
    "object_key": "105ddd05-34ce-46b6-a872-cb32b8c98f64/38559b47-b972-4663-b1ce-5bd5a29224a4/etestbb3-2cf8-49af-b49b-64b1610032c7/Model", // 모델 오브젝트 스토리지 키
    "type": 8//8: 2D 모델, 9: 3D 모델
  }
}

비정상 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, // 비정상 RTH 종료 사유: "2": "비헤이비어 트리 초기화 실패"; "3": "장애물에 둘러싸임"; "4": "비행 제한 트리거됨"; "5": "장애물이 너무 가까움"; "6": "GPS 신호 없음"; "7": "GPS 및 VIO 위치 출력 플래그가 false"; "8": "GPS와 VIO 융합 간 큰 위치 오차"
    "sn": "158TESTGD24BK0010114" // 비정상 RTH 종료가 발생한 기체의 SN
  }
}

조직 주석 추가/수정 알림

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

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

FlightHub 매핑 API - 모델 재구성 진행 상태

{
    "msg_type": "model_reconstruction_percent_change", // 메시지 유형, model_reconstruction_percent_change=모델 재구성, model_zip_change=모델 압축
    "resource_uuid": "7417bac3-00a4-4e07-b078-233c77e3fdf9",
    "model_uuid": "3d33643c-de0d-4070-b155-8cf791e662e2",
    "model_status": 14, // 재구성 상태, 9=모델 압축, 12=리소스 대기 중, 13=리소스 획득 실패, 14=재구성 진행 중, 15=재구성 성공, 16=재구성 취소
    "model_size": 37353992,
    "reconstruction_progress": 100, // 재구성 진행률, 0-100
    "error_code": 0, // 재구성 오류 코드
    "zip_status": 2, // 압축 상태, 1=압축 진행 중, 2=압축 완료, 3=압축 실패
    "zip_progress": 100, // 압축 진행률 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", // 압축된 출력 파일의 다운로드 주소
}