Public Cloud V2.0

2026-09-20

Présentation de l’API

Public Cloud OpenAPI V2.0 est une plateforme ouverte basée sur les spécifications RESTful, conçue pour offrir aux développeurs l’interopérabilité des données et l’intégration métier entre les plateformes cloud tierces et le FlightHub 2 Public Cloud.
Grâce à OpenAPI V2.0, les développeurs peuvent réaliser des intégrations système autour des données relatives aux organisations et aux membres, aux appareils, aux tâches de vol, aux diffusions en direct, etc., et construire des applications métier telles que la supervision des appareils, la supervision des tâches et la diffusion en direct.

Par rapport à la V1.0, la V2.0 ajoute, sur la base des fonctionnalités existantes, davantage d’interfaces de requête et d’interfaces orientées scénarios métier. Cette version optimise également le système d’interfaces en séparant la documentation des interfaces Public Cloud et On-Premises, rendant la catégorisation plus claire afin de faciliter une compréhension et une intégration plus rapides par les développeurs, et permettant à OpenAPI d’adopter un rythme d’itération plus agile à l’avenir.

Liste des fonctionnalités

FonctionnalitéDescription
Requête des informations sur l’organisation, le projet et les membresFournit des capacités de requête pour la liste des organisations, la liste des projets, la liste des utilisateurs, la liste des autorisations, les autorisations de rôle, etc.
Requête des informations sur les appareilsRécupère les listes d’appareils sous les organisations ou les projets, les détails des appareils du projet, la topologie historique des appareils, les informations HMS, les informations du modèle d’objet, la qualité de la transmission vidéo, etc., pour la gestion des actifs d’appareils et l’affichage de l’état.
Tâches de volPrend en charge la création de tâches de vol, la requête de listes de tâches, des détails des tâches, des trajectoires de vol, des ressources multimédias, du téléchargement des enregistrements de vol, des journaux d’opérations, des alertes de vol AI, etc.
Contrôle en temps réelPrend en charge la requête de l’état du droit de contrôle de l’appareil, l’obtention du droit de contrôle, le changement de caméra, etc.
Diffusion en direct et transfertPrend en charge le démarrage de diffusions en direct, la requête des tâches d’enregistrement, ainsi que la création, la requête et la suppression de transmetteurs de flux.
Requête des itinéraires de volPrend en charge la récupération de la liste des itinéraires de vol d’un projet, l’obtention des détails des itinéraires de vol, etc.
Reconstruction de modèlePrend en charge le lancement de tâches de modélisation à partir des données multimédias collectées par les tâches de vol FlightHub.
Modélisation ouvertePrend en charge le lancement de tâches de modélisation à partir des données multimédias des clouds tiers.

Documentation des interfaces

  • La documentation des interfaces comprend la liste des fonctionnalités OpenAPI, des tutoriels, la liste des interfaces et leurs descriptions. Pour plus de détails, reportez-vous à : Documentation des interfaces Open API.

Code source d'exemple

Après avoir déployé le code source d'exemple et l'avoir exécuté avec succès, vous pourrez découvrir l'interface fonctionnelle développée à partir d'OpenAPI V2.0. Grâce au code source d'exemple, vous pouvez également comprendre rapidement les modalités d'intégration et d'utilisation d'OpenAPI, afin d'accélérer le développement et l'intégration.

Cliquez sur Code source d'exemple pour obtenir le code source et le guide d'intégration.

Architecture du produit

Démarrage rapide

Authentification et autorisation

Reportez-vous au document Tutoriel d’authentification et d’autorisation pour comprendre les principes d’authentification et d’autorisation d’OpenAPI, et obtenir X-User-Token et X-Project-Uuid. Ces deux paramètres doivent être transmis dans le champ header de la plupart des interfaces, afin de garantir la sécurité d’OpenAPI et de mettre en œuvre le contrôle d’accès à FlightHub 2.

Exemple de code

1. Interroger l’état du système FlightHub 2

FlightHub 2 Public Cloud appelle l’interface pour interroger l’état du système : Interroger l’état du système FlightHub 2

```http
GET /openapi/v2.0/system_status HTTP/1.1
Host: 127.0.0.1:30812
X-Language: zh
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
X-User-Token: xxxxxxxx

Une valeur de retour de 0 indique que le système FlightHub 2 fonctionne normalement :

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

2. Obtenir la liste des projets sous l’organisation

Créez une organisation, un projet et liez les appareils dans FlightHub 2. Reportez-vous à la section Bases de la plateforme > Gestion de l'organisation de ce manuel pour la création d’organisations et de projets dans FlightHub 2, puis appelez l’interface Obtenir la liste des projets sous l’organisation pour obtenir la liste des projets créés.

GET /openapi/v2.0/project?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: zh
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
X-User-Token: xxxxxxxx

La liste des projets créés sera renvoyée :

```http 
{
  "code": 0,
  "message": "",
  "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. Activer la fonction de diffusion en direct

Reportez-vous au document Gestion des appareils de ce manuel pour la liaison des appareils dans FlightHub 2, puis reportez-vous au tutoriel de gestion des diffusions en direct, et appelez l’interface Activer la diffusion en direct pour démarrer la diffusion.

```http 
POST /openapi/v2.0/live-stream/start HTTP/1.1
Host: 127.0.0.1:30812
X-Project-Uuid: xxxxxxxxxx
X-Language: zh
X-Request-Id: 550e8400-e29b-41d4-a716-446655440000
Content-Type: application/json
X-User-Token:  xxxxxxxx 
Content-Length: 119

{
    "sn": "7CTDM3Dxxxxxx",
    "camera_index": "165-0-7",
    "video_expire": 7200,
    "quality_type": "adaptive"
}

Renvoie les informations d’autorisation de la diffusion en direct : data.url doit être utilisé en combinaison avec le SDK du fournisseur correspondant indiqué par data.url_type pour récupérer le flux en direct :

```c
{
  "code": 0,
  "message": "",
  "data": {
    "expire_ts": 1779446430,
    "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: