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.
Přehled
Vyhledávejte veřejné lety podle sériového čísla/MAC, štítku zařízení nebo štítku soutěžícího a získejte stránkovaný seznam. Výraz se hledá kdekoli v těchto polích (podřetězec, nezáleží na velikosti písmen). Každý výsledek nese klíčové hodnoty potřebné pro zobrazení seznamu: ID letu, sériové číslo, štítek, apogeum, hlavní náhled, odkaz na stránku letu a odkaz na stažení CSV.
Vracejí se pouze veřejně viditelné lety, stejná množina, jaká se zobrazuje na veřejných stránkách letů.
Koncový bod
q, limit, page
Parametry
| Parametr | Typ | Popis |
|---|---|---|
q | string | Hledaný výraz, alespoň 2 znaky. Porovnává se se sériovým číslem/MAC, štítkem zařízení a štítkem soutěžícího |
limit | integer | Výsledky na stránku. Výchozí 100, maximum 200 |
page | integer | Číslo stránky, počínaje 1. Výchozí 1 |
Požadavek
curl "https://www.altimetercloud.com/cz/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/cz/api/flight_search/?q=1051-dbec"
Odpověď
{
"success": true,
"query": "MY-NANO",
"competitor_search": true,
"page": 1,
"limit": 100,
"total": 2,
"count": 2,
"flights": [
{
"id": 1234,
"url": "https://www.altimetercloud.com/cz/flights/1234/",
"csv_url": "https://www.altimetercloud.com/cz/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/cz/flightdata/4/1234.webp",
"thumbnail_large": "https://www.altimetercloud.com/cz/flightdata/4/1234_l.webp"
}
]
}
Pole nejvyšší úrovně
| Pole | Typ | Popis |
|---|---|---|
query | string | Spuštěný hledaný výraz |
competitor_search | boolean | Zda byl štítek soutěžícího součástí hledání (viz poznámka níže) |
page / limit | integer | Vrácená stránka a velikost stránky |
total | integer | Celkový počet odpovídajících letů na všech stránkách. Vydělte hodnotou limit pro získání počtu stránek |
count | integer | Počet letů na této stránce |
flights | array | Stránka výsledků |
Pole výsledku
| Pole | Typ | Popis |
|---|---|---|
id / url | integer / string | ID letu v cloudu a jeho veřejná stránka letu |
csv_url | string | Přímý odkaz ke stažení surového CSV záznamu |
mac | string | Sériové číslo / MAC zařízení |
tag / competitor_tag | string | Štítek zařízení a štítek soutěžícího |
device / firmware / revision | string | Model, verze firmwaru a revize hardwaru |
apogee | float | Maximální výška v metrech |
apogee_time | integer | Čas apogea v milisekundách |
uploaddate / uploadstamp | string / integer | Text data nahrání a časové razítko Unix |
thumbnail / thumbnail_large | string | Hlavní obrázek grafu (metry), malý a velký |
Hledání podle štítku soutěžícího
Příznak competitor_search uvádí, zda byl štítek soutěžícího součástí hledání. Štítek soutěžícího se čte z letového záznamu při nahrávání; pokud jej vaše instalace ukládá jako sloupec letu, tento koncový bod jej automaticky prohledává a vrací. Jinak hledání pokrývá pouze sériové číslo/MAC a štítek zařízení a competitor_search je false. Chcete-li přesto získat štítek soutěžícího jednoho letu, použijte koncový bod Informace o letu, který jej čte přímo ze záznamu.
Testovací prostředí API
Zadejte výraz (sériové číslo, štítek nebo soutěžícího) a klikněte na Spustit pro hledání.
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.



















