Flight information API

Überblick

Dieser Endpunkt liefert eine öffentliche Zusammenfassung eines einzelnen Flugs, einschließlich Links zu seinen Diagramm-Vorschaubildern in allen Größen. Suchen Sie einen Flug entweder über seine Cloud-Flug-ID oder über den Signatur-Hash, den der Verifizierer als flight_unique_id zurückgibt (derselbe Wert, den ein Pilot aus der Protokolldatei selbst ablesen kann).

Es ist eine einzelne indizierte Abfrage und gibt keine personenbezogenen Informationen zurück: kein Konto, keine Geräte-Seriennummer, keine Upload-Adresse, keine Notizen, Bilder oder Startkoordinaten. Geräte-Tag und Teilnehmer-Tag sind enthalten, da sie einen Eintrag und nicht eine Person identifizieren.

Endpunkt

Geben Sie entweder die numerische id oder den Signatur-hash an. Sind beide angegeben, hat id Vorrang. Es werden nur öffentlich sichtbare Flüge zurückgegeben.

Parameter

Antwort

Die API liefert JSON. Barometrische Kernfelder sind für jeden Flug vorhanden. IMU-fähige Flüge (Mercury oder Nano-Hardware-Revision 4 und neuer) enthalten zusätzlich ein imu-Objekt mit Beschleunigungs-, Lage-, Dreh-, Stabilitäts- und Dual-Deploy-Daten. Mercury-Flüge enthalten außerdem ein mercury-Objekt mit zusätzlichen Sensor- und Umgebungsdaten (externe Temperatursonde, Batterie, Platinentemperatur), die nur diese Platine aufzeichnet. Rein barometrische Flüge lassen die IMU- und Mercury-Blöcke weg.

{
  "success": true,
  "flight": {
    "id": 1234,
    "url": "https://www.altimetercloud.com/de/flights/1234/",
    "csv_url": "https://www.altimetercloud.com/de/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/de/flightdata/4/1234.webp",
      "meters_large": "https://www.altimetercloud.com/de/flightdata/4/1234_l.webp",
      "feet_small":   "https://www.altimetercloud.com/de/flightdata/4/1234_ft.webp",
      "feet_large":   "https://www.altimetercloud.com/de/flightdata/4/1234_l_ft.webp",
      "miles_small":  "https://www.altimetercloud.com/de/flightdata/4/1234_mi.webp",
      "miles_large":  "https://www.altimetercloud.com/de/flightdata/4/1234_l_mi.webp",
      "km_small":     "https://www.altimetercloud.com/de/flightdata/4/1234_km.webp",
      "km_large":     "https://www.altimetercloud.com/de/flightdata/4/1234_l_km.webp"
    }
  }
}

Ein rein barometrischer Flug (zum Beispiel ein Nano unterhalb Revision 4) liefert dieselben Kernfelder mit has_imu gleich 0 und ohne imu-Block:

{
  "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"
  }
}

Wenn kein öffentlicher Flug zur angegebenen ID oder zum Hash passt:

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

Antwortfelder

Alle Messwerte werden in SI-Basiseinheiten zurückgegeben: Höhen in Metern, Geschwindigkeiten in Metern pro Sekunde, Beschleunigungen in g, Winkel in Grad, Drehung und Raten in Grad pro Sekunde, und Zeiten in Millisekunden, sofern nicht anders angegeben. Die Flugseite kann diese in Ihre gewählten Einheiten umgerechnet anzeigen, die API ist jedoch immer SI.

Kern (jeder Flug)

imu (nur IMU-fähige Flüge)

Nur vorhanden, wenn has_imu gleich 1 ist. Bei rein barometrischen Flügen nicht vorhanden.

mercury (nur Mercury-Flüge)

Nur bei Mercury vorhanden, das eine zusätzliche Sensor- und Umgebungsebene aufzeichnet, die der Nano nicht hat. Bestmöglich aus der Datendatei des Flugs gelesen, daher kann ältere Mercury-Firmware weniger Felder liefern, und jedes fehlende Feld wird einfach weggelassen.

"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
}

API-Playground

Geben Sie eine öffentliche Flug-ID (oder einen Signatur-Hash) ein und klicken Sie auf Ausführen, um die Zusammenfassung abzurufen.