Search API for tags, serials or competitor ids

Public, aucune authentification requise Recherche paginée

Présentation

Recherchez les vols publics par numéro de série/MAC, étiquette d’appareil ou étiquette de concurrent, et obtenez une liste paginée. Le terme est recherché n’importe où dans ces champs (sous-chaîne, insensible à la casse). Chaque résultat porte les valeurs clés utiles à une liste : l’identifiant du vol, le numéro de série, l’étiquette, l’apogée, la vignette principale, le lien de la page du vol et le lien de téléchargement du CSV.

Seuls les vols visibles publiquement sont renvoyés, le même ensemble que celui affiché sur les pages de vol publiques.

Point de terminaison

GET https://www.altimetercloud.com/fr/api/flight_search/ Paramètres : q, limit, page

Paramètres

ParamètreTypeDescription
qstringTerme de recherche, au moins 2 caractères. Comparé au numéro de série/MAC, à l’étiquette d’appareil et à l’étiquette de concurrent
limitintegerRésultats par page. Par défaut 100, maximum 200
pageintegerNuméro de page, à partir de 1. Par défaut 1

Requête

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

Réponse

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

Champs de premier niveau

ChampTypeDescription
querystringLe terme de recherche exécuté
competitor_searchbooleanSi l’étiquette de concurrent a été incluse dans la recherche (voir la note ci-dessous)
page / limitintegerLa page renvoyée et la taille de page
totalintegerNombre total de vols correspondants sur toutes les pages. Divisez par limit pour obtenir le nombre de pages
countintegerNombre de vols sur cette page
flightsarrayLa page de résultats

Champs de résultat

ChampTypeDescription
id / urlinteger / stringIdentifiant du vol dans le cloud et sa page de vol publique
csv_urlstringLien de téléchargement direct du journal CSV brut
macstringNuméro de série / MAC de l’appareil
tag / competitor_tagstringÉtiquette d’appareil et étiquette de concurrent
device / firmware / revisionstringModèle, version du micrologiciel et révision matérielle
apogeefloatAltitude maximale en mètres
apogee_timeintegerInstant de l’apogée en millisecondes
uploaddate / uploadstampstring / integerTexte de date de téléversement et horodatage Unix
thumbnail / thumbnail_largestringImage principale du graphique (mètres), petite et grande

Recherche par étiquette de concurrent

L’indicateur competitor_search signale si l’étiquette de concurrent faisait partie de la recherche. L’étiquette de concurrent est lue dans le journal de vol au moment du téléversement ; si votre installation la stocke comme colonne de vol, ce point de terminaison la recherche et la renvoie automatiquement. Sinon, la recherche ne couvre que le numéro de série/MAC et l’étiquette d’appareil, et competitor_search vaut false. Pour obtenir malgré tout l’étiquette de concurrent d’un seul vol, utilisez le point de terminaison Infos de vol, qui la lit directement dans le journal.

Bac à sable de l’API

Saisissez un terme (numéro de série, étiquette ou concurrent) et cliquez sur Exécuter pour rechercher.

Terme de recherche
https://www.altimetercloud.com/fr/api/flight_search/