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.
Przegląd
Wyszukuj loty publiczne według numeru seryjnego/MAC, etykiety urządzenia lub etykiety zawodnika i otrzymaj stronicowaną listę. Termin jest dopasowywany w dowolnym miejscu tych pól (fragment tekstu, bez rozróżniania wielkości liter). Każdy wynik zawiera kluczowe wartości potrzebne w widoku listy: identyfikator lotu, numer seryjny, etykietę, apogeum, główną miniaturę, odnośnik do strony lotu oraz odnośnik do pobrania CSV.
Zwracane są tylko loty widoczne publicznie, ten sam zbiór, który pokazują publiczne strony lotów.
Punkt końcowy
q, limit, page
Parametry
| Parametr | Typ | Opis |
|---|---|---|
q | string | Wyszukiwana fraza, co najmniej 2 znaki. Dopasowywana do numeru seryjnego/MAC, etykiety urządzenia i etykiety zawodnika |
limit | integer | Wyniki na stronę. Domyślnie 100, maksymalnie 200 |
page | integer | Numer strony, zaczynając od 1. Domyślnie 1 |
Żądanie
curl "https://www.altimetercloud.com/po/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/po/api/flight_search/?q=1051-dbec"
Odpowiedź
{
"success": true,
"query": "MY-NANO",
"competitor_search": true,
"page": 1,
"limit": 100,
"total": 2,
"count": 2,
"flights": [
{
"id": 1234,
"url": "https://www.altimetercloud.com/po/flights/1234/",
"csv_url": "https://www.altimetercloud.com/po/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/po/flightdata/4/1234.webp",
"thumbnail_large": "https://www.altimetercloud.com/po/flightdata/4/1234_l.webp"
}
]
}
Pola najwyższego poziomu
| Pole | Typ | Opis |
|---|---|---|
query | string | Wykonana fraza wyszukiwania |
competitor_search | boolean | Czy etykieta zawodnika była częścią wyszukiwania (zobacz uwagę poniżej) |
page / limit | integer | Zwrócona strona i rozmiar strony |
total | integer | Łączna liczba pasujących lotów na wszystkich stronach. Podziel przez limit, aby uzyskać liczbę stron |
count | integer | Liczba lotów na tej stronie |
flights | array | Strona wyników |
Pola wyniku
| Pole | Typ | Opis |
|---|---|---|
id / url | integer / string | Identyfikator lotu w chmurze i jego publiczna strona lotu |
csv_url | string | Bezpośredni odnośnik do pobrania surowego dziennika CSV |
mac | string | Numer seryjny / MAC urządzenia |
tag / competitor_tag | string | Etykieta urządzenia i etykieta zawodnika |
device / firmware / revision | string | Model, wersja oprogramowania i wersja sprzętu |
apogee | float | Maksymalna wysokość w metrach |
apogee_time | integer | Czas apogeum w milisekundach |
uploaddate / uploadstamp | string / integer | Tekst daty przesłania i znacznik czasu Unix |
thumbnail / thumbnail_large | string | Główny obraz wykresu (metry), mały i duży |
Wyszukiwanie według etykiety zawodnika
Flaga competitor_search informuje, czy etykieta zawodnika była częścią wyszukiwania. Etykieta zawodnika jest odczytywana z dziennika lotu podczas przesyłania; jeśli Twoja instalacja przechowuje ją jako kolumnę lotu, ten punkt końcowy automatycznie ją przeszukuje i zwraca. W przeciwnym razie wyszukiwanie obejmuje tylko numer seryjny/MAC i etykietę urządzenia, a competitor_search ma wartość false. Aby mimo to pobrać etykietę zawodnika pojedynczego lotu, użyj punktu końcowego Informacje o locie, który odczytuje ją bezpośrednio z dziennika.
Środowisko testowe API
Wpisz frazę (numer seryjny, etykietę lub zawodnika) i kliknij Uruchom, aby wyszukać.
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.



















