Versión privada V2.0

2026-09-20

Introducción a la API

La OpenAPI V2.0 local es una plataforma abierta basada en especificaciones RESTful, diseñada para proporcionar a los desarrolladores la interoperabilidad de datos y la integración empresarial entre plataformas de nube privada de terceros y la versión local de DJI FlightHub 2.

Mediante OpenAPI V2.0, los desarrolladores pueden realizar integraciones de sistemas en torno a módulos clave como la gestión de dispositivos, la gestión de tareas de vuelo y la gestión de datos (datos multimedia, de modelos y de mapas), para impulsar casos de uso como la interoperabilidad de datos, la gestión de dispositivos, la programación de tareas y el control en tiempo real ligero sobre FlightHub 2.

En comparación con la V1.0, la V2.0 toma los escenarios de ciclo cerrado de desarrollo secundario como su objetivo principal. Sobre la base de las capacidades existentes, completa sistemáticamente las API para módulos clave como la gestión de dispositivos, la gestión de tareas de vuelo y la gestión de datos (datos multimedia, de modelos y de mapas), elevando el número total de interfaces a más de 300 (la V1.0 tenía 67).

Asimismo, reestructura el sistema de interfaces separando la documentación de las interfaces de la nube pública y la local, lo que hace que la clasificación sea más clara, facilita la rápida incorporación e integración de los desarrolladores y permite una iteración más ágil de OpenAPI en el futuro.

Lista de funciones

FunciónDescripción
Gestión de organizaciones y proyectosProporciona capacidades de consulta y gestión de proyectos, miembros y permisos de roles.
Gestión de dispositivosPermite la consulta y gestión de dispositivos, incluyendo lista de dispositivos, estado en tiempo real, sombra del modelo de objetos, eventos de salud HMS, configuración de red y RTK, para construir sistemas de gestión y configuración de dispositivos.
Tareas de vueloPermite crear tareas de vuelo, consultar la lista de tareas y los detalles de ejecución, los registros de vuelo y las alertas de AI, para construir sistemas de gestión de tareas de vuelo.
Control en tiempo realPermite consultar y obtener el permiso de control en la nube, enviar comandos de vuelo punto a punto, órbita POI, control de cámara y más, permitiendo un control en tiempo real ligero y a nivel empresarial.
Transmisión en directoPermite la gestión de transmisiones en directo y de reenvío de flujos, el cambio de cámaras y de calidad, entre otras capacidades, para construir sistemas de gestión de transmisión en directo.
Gestión de archivos multimediaPermite la consulta, gestión y descarga de archivos multimedia, para construir sistemas de gestión de archivos multimedia.
Gestión de modelosPermite iniciar tareas de reconstrucción y gestionar los activos de modelos, para construir sistemas de gestión de modelos.
Gestión de rutas de vueloPermite obtener la lista de rutas de vuelo, gestionar los archivos de rutas de vuelo y más, para construir sistemas de gestión de archivos de rutas de vuelo.
Gestión de datos de mapasPermite la gestión de anotaciones, la gestión de áreas de vuelo personalizadas, la consulta de mapas de calor de señal, entre otras capacidades.
Detección de cambiosPermite iniciar tareas de análisis de cambios y consultar los resultados de detección, aplicable a escenarios como la supervisión de obras y la comparación de inspecciones.
Modelado abiertoPermite iniciar tareas de modelado utilizando los datos multimedia de plataformas de terceros.

Documentación de la interfaz

  • La documentación de la interfaz incluye la lista de funciones de OpenAPI, tutoriales, lista de interfaces y descripciones de las interfaces. Para más información, consulte: Documentación de la interfaz de OpenAPI.

Código fuente de ejemplo

Después de desplegar el código fuente de ejemplo y ejecutarlo correctamente, podrá experimentar la interfaz de funciones desarrollada con OpenAPI V2.0. A través del código fuente de ejemplo, también podrá comprender rápidamente la forma de integración y el método de uso de OpenAPI, acelerando el desarrollo y la integración.

Haga clic en Código fuente de ejemplo para obtener el código fuente y la guía de integración.

Arquitectura del producto

Inicio rápido

Configuración del entorno (específico para la versión local de FlightHub 2)

Consulte el Manual de despliegue de la versión local de DJI FlightHub 2 para desplegar la versión local de FlightHub 2.

Autenticación y autorización

Consulte el documento Tutorial de autenticación y autorización para comprender los principios de autenticación y autorización de OpenAPI y obtener x-user-token y X-Project-Uuid. Estos dos parámetros deberán incluirse en el campo de encabezado de la mayoría de las interfaces para garantizar la seguridad de OpenAPI e implementar el control de acceso a FlightHub 2.

Código de ejemplo

1. Consultar el estado del servicio de control en tiempo real de FlightHub 2

Una vez que la versión local de FlightHub 2 se haya desplegado correctamente, llame a la interfaz para consultar el estado del servicio de control en tiempo real: Consultar el estado del sistema de FlightHub 2

```http
GET /openapi/v2.0/drc/health HTTP/1.1
Host: 127.0.0.1:30812
X-Language: es
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
X-Project-Uuid: xxxxxxxxxx
x-user-token: xxxxxxxx

Si la interfaz devuelve 0, significa que el servicio de control en tiempo real de FlightHub 2 está funcionando correctamente:

```http 
{
  "code": 0,
  "message": "OK",
  "data": null
}

2. Obtener la lista de proyectos de la organización

Cree una organización, configure un proyecto y vincule dispositivos en FlightHub 2. Consulte la sección Aspectos básicos de la plataforma > Gestión de la organización de este manual para realizar las operaciones de creación de organizaciones y proyectos en FlightHub 2 y, a continuación, llame a la interfaz Obtener la lista de proyectos de la organización para obtener la lista de proyectos creados.

GET /openapi/v2.0/manage/api/v1/organizations/{uuid}/projects?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: es
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
X-Project-Uuid: xxxxxxxxxx
x-user-token: xxxxxxxx

Devuelve la lista de proyectos creados:

```http 
{
  "code": 0,
  "message": "OK",
  "data": {
    "list": [
      {
        "name": "c2c_test",
        "introduction": "a",
        "uuid": "b2c3d4e5-6789-0123-bcde-f12345678901",
        "project_id": "PRJ202401001",
        "org_uuid": "a1b2c3d4-5678-9012-abcd-ef1234567890",
        "status": "active",
        "c2c_enable": true,
        "dock_rotation_disabled": false,
        "c2c_task_enable": true,
        "created_at": 1700000000,
        "updated_at": 1700100000
      }
    ]
  }
}

3. Habilitar la función de transmisión en directo

Consulte el documento de este manual Gestión de dispositivos para realizar las operaciones de vinculación de dispositivos en FlightHub 2, luego consulte el documento Tutorial de gestión de transmisión en directo para iniciar el envío de la transmisión en directo.

```http 
POST /openapi/v2.0/drc/api/v2/projects/{proj_uuid}/live-channels/stream/start HTTP/1.1
Host: 127.0.0.1:30812
X-Project-Uuid: xxxxxxxxxx
X-Language: es
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
Content-Type: application/json
x-user-token:  xxxxxxxx 
Content-Length: 130

{
    "sn": "1ZNBH1Dxxxxxxx",
    "camera": "165-0-7",
    "video": "normal-0",
    "gateway_sn": "7CTDM3Dxxxxxxx",
    "video_quality": 0
}

Si la interfaz devuelve 0, significa que la tarea de transmisión se ha enviado correctamente y el dispositivo comenzará a enviar el flujo al servidor multimedia según la configuración:

```c
{
  "code": 0,
  "message": "OK",
  "data": null
}
Last Updated: