CSV Flight log verification API

Überblick

Von unseren Höhenmessern erzeugte CSV-Flugprotokolle enthalten eine kryptografische Verifizierungssignatur. Diese API prüft, ob ein Flugprotokoll echt und genau so ist, wie es vom Höhenmesser geschrieben wurde, oder ob es verändert wurde.

Die Signatur wird im Höhenmesser durch AES-256-verschlüsselte Firmware erzeugt, wodurch eine Fälschung rechnerisch praktisch unmöglich ist. Firmware 1.52 und neuer signieren das Protokoll mit einer Ed25519-Signatur; ältere Firmware verwendet einen SHA-256-basierten Hash. In beiden Fällen müssen sowohl die Flugdaten als auch die Kopf-Einstellungen unverändert sein, um die Verifizierung zu bestehen.

Dies unterstützt derzeit den Nano-Höhenmesser, Unterstützung für alle Geräte folgt in Kürze. Sie können Protokolle auch mit dem Upload-Werkzeug verifizieren.

Endpunkt

Senden Sie das gesamte CSV-Flugprotokoll unverändert per POST an den obigen Endpunkt. Der CSV-Inhalt sollte unter dem Parameter csv gesendet werden.

Antwort

Die API liefert JSON. Bei Erfolg erhalten Sie die verwendete Verifizierungsmethode und die ausgelesenen Flugdetails:

{
  "success": true,
  "log_lines": 825,
  "input_bytes": 4187,
  "verify_method": "SHA-256",
  "firmware": "1.43b",
  "hardware": "2",
  "device_tag": "MyNano",
  "competitor_tag": "",
  "apogee": 2.54,
  "apogee_time": 826,
  "max_velocity": 5.910,
  "landing_m": 0.784,
  "landing_t": 2.253,
  "flight_unique_id": "e1eb3e800d780a0b69670f03a88e2f45c592b6e79065fc08cf83241530a60c5a"
}

Wenn das Flugprotokoll die Verifizierung nicht besteht oder die Anfrage leer ist:

{
  "success": false,
  "log_lines": 825,
  "error": {
    "code": "400",
    "message": "Flight log failed verification (STEP=SHA256)"
  }
}

{
  "success": false,
  "error": {
    "code": "412",
    "message": "No flight log supplied as a POST using the parameter csv="
  }
}

Antwortfelder

API-Playground

Testen Sie die API live. Wir haben unten ein Beispiel-Flugprotokoll eines Nano V1 vorgeladen. Klicken Sie auf Ausführen, um es zu verifizieren, oder bearbeiten Sie die Daten, um eine fehlgeschlagene Verifizierung zu testen.