Search API for tags, serials or competitor ids

Público, sem autenticação Pesquisa paginada

Visão geral

Pesquise voos públicos por número de série/MAC, etiqueta do dispositivo ou etiqueta de concorrente e obtenha uma lista paginada. O termo é procurado em qualquer parte desses campos (subcadeia, sem distinção de maiúsculas). Cada resultado traz os valores principais que uma vista de lista precisa: o id do voo, o número de série, a etiqueta, o apogeu, a miniatura principal, a ligação para a página do voo e a ligação de transferência do CSV.

Apenas são devolvidos os voos publicamente visíveis, o mesmo conjunto mostrado nas páginas de voo públicas.

Ponto final

GET https://www.altimetercloud.com/pt/api/flight_search/ Parâmetros: q, limit, page

Parâmetros

ParâmetroTipoDescrição
qstringTermo de pesquisa, pelo menos 2 carateres. Comparado com número de série/MAC, etiqueta do dispositivo e etiqueta de concorrente
limitintegerResultados por página. Predefinição 100, máximo 200
pageintegerNúmero da página, a começar em 1. Predefinição 1

Pedido

curl "https://www.altimetercloud.com/pt/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/pt/api/flight_search/?q=1051-dbec"

Resposta

✓ Resultados
{
  "success": true,
  "query": "MY-NANO",
  "competitor_search": true,
  "page": 1,
  "limit": 100,
  "total": 2,
  "count": 2,
  "flights": [
    {
      "id": 1234,
      "url": "https://www.altimetercloud.com/pt/flights/1234/",
      "csv_url": "https://www.altimetercloud.com/pt/flightdata/4/1234.csv",
      "mac": "1051-dbec-747c",
      "tag": "MY-NANO",
      "competitor_tag": "C-07",
      "device": "nanov1",
      "firmware": "1.52",
      "revision": "4",
      "apogee": 246.4,
      "apogee_time": 5210,
      "uploaddate": "10/06/26-14:22:01",
      "uploadstamp": 1781453721,
      "thumbnail": "https://www.altimetercloud.com/pt/flightdata/4/1234.webp",
      "thumbnail_large": "https://www.altimetercloud.com/pt/flightdata/4/1234_l.webp"
    }
  ]
}

Campos de nível superior

CampoTipoDescrição
querystringO termo de pesquisa executado
competitor_searchbooleanSe a etiqueta de concorrente foi incluída na pesquisa (ver a nota abaixo)
page / limitintegerA página devolvida e o tamanho da página
totalintegerTotal de voos correspondentes em todas as páginas. Divida por limit para obter o número de páginas
countintegerNúmero de voos nesta página
flightsarrayA página de resultados

Campos de resultado

CampoTipoDescrição
id / urlinteger / stringId do voo na nuvem e a sua página de voo pública
csv_urlstringLigação de transferência direta do registo CSV em bruto
macstringNúmero de série / MAC do dispositivo
tag / competitor_tagstringEtiqueta do dispositivo e etiqueta de concorrente
device / firmware / revisionstringModelo, versão do firmware e revisão de hardware
apogeefloatAltitude máxima em metros
apogee_timeintegerMomento do apogeu em milissegundos
uploaddate / uploadstampstring / integerTexto de data de envio e carimbo de data/hora Unix
thumbnail / thumbnail_largestringImagem principal do gráfico (metros), pequena e grande

Pesquisa por etiqueta de concorrente

O indicador competitor_search indica se a etiqueta de concorrente fez parte da pesquisa. A etiqueta de concorrente é lida do registo de voo no momento do envio; se a sua instalação a armazenar como coluna de voo, este ponto final pesquisa-a e devolve-a automaticamente. Caso contrário, a pesquisa abrange apenas número de série/MAC e etiqueta do dispositivo, e competitor_search é false. Para obter mesmo assim a etiqueta de concorrente de um único voo, use o ponto final Informações de voo, que a lê diretamente do registo.

Zona de testes da API

Introduza um termo (número de série, etiqueta ou concorrente) e clique em Executar para pesquisar.

Termo de pesquisa
https://www.altimetercloud.com/pt/api/flight_search/