CSV Flight log verification API

Přehled

Záznamy letu CSV vytvořené našimi výškoměry obsahují kryptografický ověřovací podpis. Toto API ověří, zda je letový záznam pravý a přesně takový, jak jej zapsal výškoměr, nebo zda byl změněn.

Podpis se generuje uvnitř výškoměru firmwarem šifrovaným AES-256, takže jeho padělání je výpočetně neproveditelné. Firmware 1.52 a novější podepisuje záznam podpisem Ed25519; starší firmware používá hash založený na SHA-256. V obou případech musí zůstat data letu i nastavení v hlavičce nezměněná, aby záznam prošel ověřením.

Aktuálně je podporován výškoměr Nano, podpora všech zařízení bude brzy. Záznamy můžete ověřit také pomocí nástroje pro nahrávání.

Koncový bod

Odešlete metodou POST celý letový záznam CSV, neupravený, na výše uvedený koncový bod. Obsah CSV se má odeslat pod parametrem csv.

Odpověď

API vrací JSON. Při úspěchu obdržíte použitou metodu ověření a načtené podrobnosti letu:

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

Pokud letový záznam neprojde ověřením nebo je požadavek prázdný:

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

Pole odpovědi

Testovací prostředí API

Vyzkoušejte API naživo. Níže jsme předvyplnili ukázkový letový záznam Nano V1. Kliknutím na Spustit jej ověřte, nebo upravte data a otestujte neúspěšné ověření.