Search API for tags, serials or competitor ids

Openbaar, geen authenticatie Gepagineerd zoeken

Overzicht

Doorzoek openbare vluchten op serienummer/MAC, apparaatlabel of deelnemerslabel en krijg een gepagineerde lijst terug. De term wordt overal in die velden gezocht (deeltekst, hoofdletterongevoelig). Elk resultaat bevat de kerngegevens die een lijstweergave nodig heeft: het vlucht-id, serienummer, label, apogee, de hoofdminiatuur, de link naar de vluchtpagina en de CSV-downloadlink.

Alleen openbaar zichtbare vluchten worden teruggegeven, dezelfde set die op de openbare vluchtpagina's wordt getoond.

Eindpunt

GET https://www.altimetercloud.com/nl/api/flight_search/ Parameters: q, limit, page

Parameters

Parameter	Type	Beschrijving
`q`	string	Zoekterm, minstens 2 tekens. Vergeleken met serienummer/MAC, apparaatlabel en deelnemerslabel
`limit`	integer	Resultaten per pagina. Standaard 100, maximum 200
`page`	integer	Paginanummer, beginnend bij 1. Standaard 1

Verzoek

curl "https://www.altimetercloud.com/nl/api/flight_search/?q=MY-NANO&limit=50&page=1"
curl "https://www.altimetercloud.com/nl/api/flight_search/?q=1051-dbec"

Antwoord

✓ Resultaten

{
  "success": true,
  "query": "MY-NANO",
  "competitor_search": true,
  "page": 1,
  "limit": 100,
  "total": 2,
  "count": 2,
  "flights": [
    {
      "id": 1234,
      "url": "https://www.altimetercloud.com/nl/flights/1234/",
      "csv_url": "https://www.altimetercloud.com/nl/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/nl/flightdata/4/1234.webp",
      "thumbnail_large": "https://www.altimetercloud.com/nl/flightdata/4/1234_l.webp"
    }
  ]
}

Velden op hoofdniveau

Veld	Type	Beschrijving
`query`	string	De uitgevoerde zoekterm
`competitor_search`	boolean	Of het deelnemerslabel deel uitmaakte van het zoeken (zie opmerking hieronder)
`page` / `limit`	integer	De teruggegeven pagina en de paginagrootte
`total`	integer	Totaal aantal overeenkomende vluchten over alle pagina's. Deel door `limit` voor het aantal pagina's
`count`	integer	Aantal vluchten op deze pagina
`flights`	array	De resultatenpagina

Resultaatvelden

Veld	Type	Beschrijving
`id` / `url`	integer / string	Cloud-vlucht-id en de openbare vluchtpagina
`csv_url`	string	Directe downloadlink voor het ruwe CSV-log
`mac`	string	Serienummer / MAC van het apparaat
`tag` / `competitor_tag`	string	Apparaatlabel en deelnemerslabel
`device` / `firmware` / `revision`	string	Model, firmwareversie en hardwarerevisie
`apogee`	float	Maximale hoogte in meters
`apogee_time`	integer	Tijdstip van apogeum in milliseconden
`uploaddate` / `uploadstamp`	string / integer	Uploaddatumtekst en Unix-tijdstempel
`thumbnail` / `thumbnail_large`	string	Hoofdgrafiekafbeelding (meters), klein en groot

Zoeken op deelnemerslabel

De vlag competitor_search geeft aan of het deelnemerslabel deel uitmaakte van het zoeken. Het deelnemerslabel wordt bij het uploaden uit het vluchtlog gelezen; als uw installatie het als vluchtkolom opslaat, doorzoekt en retourneert dit eindpunt het automatisch. Zo niet, dan dekt het zoeken alleen serienummer/MAC en apparaatlabel, en is competitor_search gelijk aan false. Om toch het deelnemerslabel van een enkele vlucht op te halen, gebruikt u het eindpunt Vluchtinformatie, dat het rechtstreeks uit het log leest.

API-speeltuin

Voer een term in (serienummer, label of deelnemer) en klik op Uitvoeren om te zoeken.

Zoekterm

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

Cloud-API

Invoering CSV-verificatie Vluchtinfo Upload-API Zoeken