Search API for tags, serials or competitor ids

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

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ź

✓ 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

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ć.

Wyszukiwana fraza

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

API Chmury

Wstęp Weryfikacja CSV Info o locie API przesyłania Wyszukiwanie