Flight information API

Présentation

Ce point de terminaison renvoie un résumé public d’un seul vol, y compris les liens vers ses vignettes de graphique dans toutes les tailles. Recherchez un vol soit par son identifiant de vol dans le cloud, soit par le hash de signature que le vérificateur renvoie sous flight_unique_id (la même valeur qu’un pilote peut lire dans le fichier journal lui-même).

Il s’agit d’une seule recherche indexée qui ne renvoie aucune information identifiant l’utilisateur : pas de compte, pas de numéro de série d’appareil, pas d’adresse de téléversement, pas de notes, d’images ni de coordonnées de lancement. L’étiquette d’appareil et l’étiquette de concurrent sont incluses, car elles identifient une entrée plutôt qu’une personne.

Point de terminaison

Fournissez soit l’id numérique, soit le hash de signature. Si les deux sont fournis, id a la priorité. Seuls les vols visibles publiquement sont renvoyés.

Paramètres

Réponse

L’API renvoie du JSON. Les champs barométriques de base sont présents pour chaque vol. Les vols dotés d’une IMU (Mercury, ou Nano de révision matérielle 4 et ultérieure) incluent aussi un objet imu avec des données d’accélération, d’orientation, de rotation, de stabilité et de double déploiement. Les vols Mercury incluent en plus un objet mercury avec des données de capteur et d’environnement supplémentaires (sonde de température externe, batterie, température de la carte) que seule cette carte enregistre. Les vols uniquement barométriques omettent les blocs IMU et Mercury.

{
  "success": true,
  "flight": {
    "id": 1234,
    "url": "https://www.altimetercloud.com/fr/flights/1234/",
    "csv_url": "https://www.altimetercloud.com/fr/flightdata/4/1234.csv",
    "device": "nanov1",
    "firmware": "1.52",
    "revision": "4",
    "has_imu": 1,
    "tag": "MY-NANO",
    "competitor_tag": "C-07",
    "uploaddate": "10/06/26-14:22:01",
    "uploadstamp": 1781453721,
    "samples": 3210,
    "sps": 100,
    "apogee": 246.4,
    "apogee_time": 5210,
    "max_velocity": 98.3,
    "max_velocity_down": -12.4,
    "velocity_landing": 4.8,
    "landing_ms": 41800,
    "landing_m": 1.2,
    "flight_time": 41.8,
    "total_time": 44.2,
    "lockouts": 0,
    "not_real_flight": 0,
    "settings": {
      "sealevel": 1013.25,
      "samplerate": 100,
      "recordingstop": 1,
      "oversampling": 1,
      "iirfilter": 0,
      "pressurefilter": 1,
      "startuplock": 0,
      "usetemp": 1,
      "fixedtemp": 15,
      "launchdetect": 1,
      "sampleratio": 1,
      "maintainpower": 0,
      "maxsamples": 0,
      "recording_alt": 0,
      "units": 0,
      "units_velocity": 0,
      "units_acceleration": 0,
      "lockout_time": 0,
      "lockout_change": 0,
      "output_enable": 0,
      "orientation": 0,
      "launchprotection": 1
    },
    "imu": {
      "burnout": 1400,
      "ejection": 5600,
      "max_acceleration": 11.6,
      "acceleration": {
        "max_ascent": 11.6,
        "max_descent": 2.3,
        "max_burn": 11.6,
        "avg_ascent": 4.2,
        "avg_burn": 9.8
      },
      "velocity": {
        "burnout": 96.2,
        "descent": 5.1,
        "up_imu": 96.2,
        "down_imu": -11.8
      },
      "orientation": {
        "launch_pitch": 2,
        "launch_roll": 1,
        "launch_yaw": 0,
        "launch_tilt": 3,
        "max_tilt": 7
      },
      "spin": {
        "max": 540.5,
        "average": 120.2,
        "roll_rate": 33,
        "coning_rate": 4,
        "coning_power": 2
      },
      "stability": {
        "score": 92,
        "launch": 88,
        "coning": 95,
        "straight": 90,
        "confidence": 1,
        "thrust_straight": 97,
        "launch_tilt": 3
      },
      "dual_deploy": {
        "detected": 1,
        "drogue_velocity": 18.2,
        "main_velocity": 6.4,
        "main_altitude": 120.5,
        "main_time": 30200
      }
    },
    "thumbnails": {
      "meters_small": "https://www.altimetercloud.com/fr/flightdata/4/1234.webp",
      "meters_large": "https://www.altimetercloud.com/fr/flightdata/4/1234_l.webp",
      "feet_small":   "https://www.altimetercloud.com/fr/flightdata/4/1234_ft.webp",
      "feet_large":   "https://www.altimetercloud.com/fr/flightdata/4/1234_l_ft.webp",
      "miles_small":  "https://www.altimetercloud.com/fr/flightdata/4/1234_mi.webp",
      "miles_large":  "https://www.altimetercloud.com/fr/flightdata/4/1234_l_mi.webp",
      "km_small":     "https://www.altimetercloud.com/fr/flightdata/4/1234_km.webp",
      "km_large":     "https://www.altimetercloud.com/fr/flightdata/4/1234_l_km.webp"
    }
  }
}

Un vol uniquement barométrique (par exemple un Nano en deçà de la révision 4) renvoie les mêmes champs de base avec has_imu à 0 et sans bloc imu :

{
  "success": true,
  "flight": {
    "id": 980,
    "device": "nanov1",
    "firmware": "1.52",
    "revision": "2",
    "has_imu": 0,
    "apogee": 312.7,
    "apogee_time": 6120,
    "max_velocity": 104.5,
    "...": "core fields and settings, but no imu block"
  }
}

Si aucun vol public ne correspond à l’identifiant ou au hash fourni :

{
  "success": false,
  "error": {
    "code": "404",
    "message": "No public flight found for that id or signature hash"
  }
}

Champs de la réponse

Toutes les mesures sont renvoyées en unités SI de base : hauteurs en mètres, vitesses en mètres par seconde, accélérations en g, angles en degrés, rotation et taux en degrés par seconde, et temps en millisecondes sauf indication contraire. La page du vol peut les afficher converties dans les unités de votre choix, mais l’API est toujours en SI.

Base (chaque vol)

imu (vols dotés d’une IMU uniquement)

Présent uniquement lorsque has_imu vaut 1. Absent pour les vols uniquement barométriques.

mercury (vols Mercury uniquement)

Présent uniquement pour Mercury, qui enregistre une couche de capteurs et d’environnement supplémentaire que le Nano n’a pas. Lu au mieux depuis le fichier de données du vol, donc un micrologiciel Mercury plus ancien peut renvoyer moins de champs, et tout champ absent est simplement omis.

"mercury": {
  "mt1_temp_c": 16,
  "battery_start_pct": 98,
  "battery_end_pct": 95,
  "board_temp_start_c": 13.02,
  "board_temp_end_c": 12.25,
  "recovered": 0
}

Bac à sable de l’API

Saisissez un identifiant de vol public (ou un hash de signature) et cliquez sur Exécuter pour récupérer son résumé.