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 minutesHourDay
Without a key303002,000
With a key1501,50010,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.

Publiczne, bez uwierzytelniania Wyszukiwanie stronicowane

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

GET https://www.altimetercloud.com/po/api/flight_search/ Parametry: q, limit, page

Parametry

ParametrTypOpis
qstringWyszukiwana fraza, co najmniej 2 znaki. Dopasowywana do numeru seryjnego/MAC, etykiety urządzenia i etykiety zawodnika
limitintegerWyniki na stronę. Domyślnie 100, maksymalnie 200
pageintegerNumer 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ź

✓ Wyniki
{
  "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

PoleTypOpis
querystringWykonana fraza wyszukiwania
competitor_searchbooleanCzy etykieta zawodnika była częścią wyszukiwania (zobacz uwagę poniżej)
page / limitintegerZwrócona strona i rozmiar strony
totalintegerŁączna liczba pasujących lotów na wszystkich stronach. Podziel przez limit, aby uzyskać liczbę stron
countintegerLiczba lotów na tej stronie
flightsarrayStrona wyników

Pola wyniku

PoleTypOpis
id / urlinteger / stringIdentyfikator lotu w chmurze i jego publiczna strona lotu
csv_urlstringBezpośredni odnośnik do pobrania surowego dziennika CSV
macstringNumer seryjny / MAC urządzenia
tag / competitor_tagstringEtykieta urządzenia i etykieta zawodnika
device / firmware / revisionstringModel, wersja oprogramowania i wersja sprzętu
apogeefloatMaksymalna wysokość w metrach
apogee_timeintegerCzas apogeum w milisekundach
uploaddate / uploadstampstring / integerTekst daty przesłania i znacznik czasu Unix
thumbnail / thumbnail_largestringGłó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ć.

Wyszukiwana fraza
https://www.altimetercloud.com/po/api/flight_search/

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.