OpenAPI V1.0

2026-10-16

API 소개

DJI FlightHub 2 OpenAPI는 RESTful 사양을 기반으로 하며, 개발자가 타사 클라우드 플랫폼 및 DJI FlightHub 2와 상호 작용할 수 있는 기능을 제공하도록 설계된 개방형 플랫폼입니다.

OpenAPI의 주요 기능은 다음과 같습니다:

  • RESTful 설계: RESTful 사양을 채택하여 API 사용을 더욱 직관적이고 웹 표준에 부합하게 만듭니다. 개발자는 GET, POST, PUT, DELETE와 같은 표준 HTTP 메서드를 사용하여 FlightHub 2와 상호 작용할 수 있습니다.
  • 인증 및 권한 부여: 안전한 인증 및 권한 부여 메커니즘을 구현하여 API 리소스를 보호하고 액세스 권한을 효과적으로 관리합니다.
  • FlightHub 2 상호 작용: DJI FlightHub 2 조직 및 프로젝트 관리, 장치 관리, 라이브 스트림 관리, 비행 경로 관리, 임무 관리, 모델 관리 및 주석 관리와 같은 기능을 제공합니다.
  • 개발자 지원 및 문서: 자세한 API 문서, 코드 예제 및 개발자 지원을 제공하여 플랫폼 기능의 신속한 통합 및 효과적인 활용을 가능하게 합니다.

개발자는 OpenAPI를 호출하여 FlightHub 2의 핵심 기능을 신속하게 통합할 수 있으며, 개발 비용을 크게 절감하고 다양한 비즈니스 요구 사항과 혁신적인 애플리케이션 시나리오를 충족할 수 있습니다.

제품 아키텍처

퀵 스타트

환경 설정

FlightHub 2 온프레미스 버전을 배포하려면 DJI FlightHub 2 온프레미스 버전 배포 매뉴얼을 참조하십시오.

인증 및 권한 부여

Authentication and Authorizationopen in new window 튜토리얼을 참조하여 OpenAPI 인증 및 권한 부여의 원리를 이해하고, X-User-Token 및 X-Project-Uuid 값을 얻은 다음, 이 두 값을 헤더 필드에 입력하여 OpenAPI의 보안을 보장하고 FlightHub 2에 대한 액세스 제어를 달성하십시오.

샘플 코드

1. FlightHub 2 시스템 상태 조회

FlightHub 2 공개 버전는 API를 호출하여 시스템 상태를 조회합니다: Query FlightHub 2 System Statusopen in new window

FlightHub 2 온프레미스 버전이 성공적으로 배포된 후, FlightHub 2 시스템 상태 조회 메서드를 호출하여 시스템 상태를 확인하십시오: Query FlightHub 2 System Statusopen in new window

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

반환 값 0은 FlightHub 2 시스템이 정상적으로 작동 중임을 나타냅니다.

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

2. 조직에 속한 프로젝트 목록 가져오기

FlightHub 2에서 조직을 생성하고, 프로젝트를 설정하고, 장치를 바인딩합니다. DJI FlightHub 2 사용자 매뉴얼 > 조직 관리 섹션에서 FlightHub 2에서 Get the List of Projects under the Organizationopen in new window 생성에 대한 내용을 참조한 다음, 조직에 속한 프로젝트 목록 가져오기 메서드를 호출하여 생성된 프로젝트 목록을 얻으십시오.

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

생성된 프로젝트 목록이 반환됩니다.

```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. 라이브 스트림 시작

DJI FlightHub 2 사용자 매뉴얼 > 기기 관리 섹션에서 FlightHub 2의 기기 바인딩에 대해 참조한 다음, Livestream Managementopen in new window 관리 튜토리얼을 참조하고, Enable Livestreamopen in new window 메서드를 호출하여 스트리밍을 시작하십시오.

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

라이브 스트림 링크는 data.url에서 사용할 수 있으며, 해당 링크를 방문하여 라이브 스트림을 시청할 수 있습니다.

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

인터페이스 튜토리얼

Last Updated: