Public Cloud V2.0

2026-09-20

Introdução à API

A Public Cloud OpenAPI V2.0 é uma plataforma aberta baseada em especificações RESTful, projetada para oferecer aos desenvolvedores interoperabilidade de dados e integração de negócios entre plataformas em nuvem de terceiros e a nuvem pública do FlightHub 2.

Por meio da OpenAPI V2.0, os desenvolvedores podem realizar integrações de sistemas em torno de dados como organizações e membros, dispositivos, tarefas de voo, transmissões ao vivo, entre outros, e construir aplicações de negócio para supervisão de dispositivos, supervisão de tarefas, transmissões ao vivo e outros cenários.

Em comparação com a V1.0, a V2.0 acrescenta, sobre as capacidades existentes, mais interfaces de consulta e interfaces voltadas a cenários de negócio. Além disso, esta versão otimiza o sistema de interfaces, separando a documentação das interfaces da nuvem pública e da implantação local, tornando a categorização mais clara, facilitando a compreensão e integração rápidas pelos desenvolvedores e permitindo que a OpenAPI siga, no futuro, um ritmo de iteração mais ágil.

Lista de recursos

RecursoDescrição
Consulta de informações de organização, projeto e membrosFornece recursos de consulta da lista de organizações, lista de projetos, lista de usuários, lista de permissões, permissões de funções, entre outros.
Consulta de informações de dispositivosObtenção da lista de dispositivos em uma organização ou projeto, detalhes dos dispositivos do projeto, histórico de topologia dos dispositivos, informações de HMS, informações do modelo de coisas (thing model), nitidez da transmissão de vídeo e outros dados — utilizados para gestão de ativos e exibição de status dos dispositivos.
Tarefas de vooPermite criar tarefas de voo, consultar a lista de tarefas, detalhes de tarefas, trajetórias de voo, recursos de mídia, download de registros de voo, logs de operação, alertas de voo por AI, entre outros recursos.
Controle em tempo realPermite consultar o status do direito de controle do dispositivo, obtenção do direito de controle, alternância de câmeras, entre outros recursos.
Transmissão ao vivo e encaminhamentoPermite iniciar transmissões ao vivo, consultar tarefas de gravação, além de criar, consultar e excluir encaminhadores de fluxo de dados.
Consulta de rotas de vooPermite obter a lista de rotas de voo de um projeto, obter detalhes da rota de voo, entre outros recursos.
Reconstrução de modelosPermite iniciar tarefas de modelagem utilizando os dados de mídia coletados nas tarefas de voo do FlightHub.
Modelagem abertaPermite iniciar tarefas de modelagem utilizando dados de mídia provenientes de nuvens de terceiros.

Documentação das interfaces

  • A documentação das interfaces inclui a lista de recursos do OpenAPI, tutoriais, lista de interfaces e descrição das interfaces. Para mais detalhes, consulte: Documentação das interfaces da OpenAPI.

Código-fonte de exemplo

Após implantar o código-fonte de exemplo e executá-lo com sucesso, você poderá experimentar as funcionalidades da interface desenvolvidas com base na OpenAPI V2.0. Por meio do código-fonte de exemplo, você também pode conhecer rapidamente a forma de integração e o uso da OpenAPI, acelerando o desenvolvimento e a integração.

Clique em Código-fonte de exemplo para obter o código-fonte e o guia de integração.

Arquitetura do produto

Ativação rápida

Autenticação e autorização

Consulte o tutorial de autenticação e autorização para entender os princípios de autenticação e autorização da OpenAPI e obter X-User-Token e X-Project-Uuid. Esses dois parâmetros devem ser informados no campo header da maioria das interfaces, sendo utilizados para garantir a segurança da OpenAPI e implementar o controle de acesso ao FlightHub 2.

Código de exemplo

1. Consultar o status do sistema do FlightHub 2

A nuvem pública do FlightHub 2 invoca a interface para consultar o status do sistema: Consultar status do sistema do 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

Um valor de retorno igual a 0 indica que o sistema do FlightHub 2 está operando normalmente:

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

2. Obter a lista de projetos da organização

Crie uma organização no FlightHub 2, configure um projeto e vincule dispositivos. Consulte o capítulo Básico da plataforma > Gestão da organização deste manual para realizar as operações de criação de organizações e projetos no FlightHub 2 e, em seguida, invoque a interface Obter a lista de projetos da organização para obter a lista de projetos criados.

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

Será retornada a lista de projetos criados:

```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. Iniciar o recurso de transmissão ao vivo

Consulte o capítulo deste manual Gerenciamento de dispositivos para realizar a vinculação de dispositivos no FlightHub 2 e, em seguida, consulte o tutorial de gerenciamento de transmissão ao vivo e invoque a interface Iniciar transmissão ao vivo para iniciar o envio do fluxo de transmissão ao vivo.

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

Retorna as informações de autorização da transmissão ao vivo em data.url. O fluxo da transmissão deve ser obtido utilizando o SDK do fornecedor correspondente indicado em data.url_type:

```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: