Search API for tags, serials or competitor ids
Access & limitsPublic, no key needed · Light▾
Open to everyone. A free API key from your profile raises the limits: send it in an X-API-Key header, or as api_key= in the address.
| 5 minutes | Hour | Day | |
|---|---|---|---|
| Without a key | 30 | 300 | 2,000 |
| With a key | 150 | 1,500 | 10,000 |
Log in to create a free key on your profile page.
Every answer carries X-RateLimit-Remaining and X-RateLimit-Reset. Over a limit, the answer is error 429 with retry_after in seconds. Refused requests do not count.
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
q, limit, page
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
q | string | Termo de pesquisa, pelo menos 2 carateres. Comparado com número de série/MAC, etiqueta do dispositivo e etiqueta de concorrente |
limit | integer | Resultados por página. Predefinição 100, máximo 200 |
page | integer | Nú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
{
"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
| Campo | Tipo | Descrição |
|---|---|---|
query | string | O termo de pesquisa executado |
competitor_search | boolean | Se a etiqueta de concorrente foi incluída na pesquisa (ver a nota abaixo) |
page / limit | integer | A página devolvida e o tamanho da página |
total | integer | Total de voos correspondentes em todas as páginas. Divida por limit para obter o número de páginas |
count | integer | Número de voos nesta página |
flights | array | A página de resultados |
Campos de resultado
| Campo | Tipo | Descrição |
|---|---|---|
id / url | integer / string | Id do voo na nuvem e a sua página de voo pública |
csv_url | string | Ligação de transferência direta do registo CSV em bruto |
mac | string | Número de série / MAC do dispositivo |
tag / competitor_tag | string | Etiqueta do dispositivo e etiqueta de concorrente |
device / firmware / revision | string | Modelo, versão do firmware e revisão de hardware |
apogee | float | Altitude máxima em metros |
apogee_time | integer | Momento do apogeu em milissegundos |
uploaddate / uploadstamp | string / integer | Texto de data de envio e carimbo de data/hora Unix |
thumbnail / thumbnail_large | string | Imagem 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.
Crediting AltimeterCloud
Free to use. If you use this API, or anything made from the answers, in a commercial product or service, credit AltimeterCloud with a link to www.altimetercloud.com at the point of use: on the screen, page or printout where the data appears, for example “Data from AltimeterCloud.com”. Any credits the data's own sources ask for, listed on this page, apply as well.



















