Search API for tags, serials or competitor ids

Veřejné, bez ověřování Stránkované vyhledávání

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

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

Parametry

ParametrTypPopis
qstringHledaný výraz, alespoň 2 znaky. Porovnává se se sériovým číslem/MAC, štítkem zařízení a štítkem soutěžícího
limitintegerVýsledky na stránku. Výchozí 100, maximum 200
pageintegerČí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ěď

✓ Výsledky
{
  "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ě

PoleTypPopis
querystringSpuštěný hledaný výraz
competitor_searchbooleanZda byl štítek soutěžícího součástí hledání (viz poznámka níže)
page / limitintegerVrácená stránka a velikost stránky
totalintegerCelkový 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
countintegerPočet letů na této stránce
flightsarrayStránka výsledků

Pole výsledku

PoleTypPopis
id / urlinteger / stringID letu v cloudu a jeho veřejná stránka letu
csv_urlstringPřímý odkaz ke stažení surového CSV záznamu
macstringSériové číslo / MAC zařízení
tag / competitor_tagstringŠtítek zařízení a štítek soutěžícího
device / firmware / revisionstringModel, verze firmwaru a revize hardwaru
apogeefloatMaximální výška v metrech
apogee_timeintegerČas apogea v milisekundách
uploaddate / uploadstampstring / integerText data nahrání a časové razítko Unix
thumbnail / thumbnail_largestringHlavní 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í.

Hledaný výraz
https://www.altimetercloud.com/cz/api/flight_search/