CSV Flight log verification API

Resumen

Los registros de vuelo CSV producidos por nuestros altímetros incluyen una firma de verificación criptográfica. Esta API comprueba si un registro de vuelo es auténtico y exactamente como lo escribió el altímetro, o si ha sido modificado.

La firma se genera dentro del altímetro mediante firmware cifrado con AES-256, lo que hace que falsificarla sea computacionalmente inviable. El firmware 1.52 y posteriores firman el registro con una firma Ed25519; el firmware anterior usa un hash basado en SHA-256. En ambos casos, tanto los datos de vuelo como los ajustes de la cabecera deben permanecer inalterados para superar la verificación.

Actualmente es compatible con el altímetro Nano, y pronto se admitirán todos los dispositivos. También puede verificar registros con la herramienta de carga.

Punto final

Envíe por POST todo el registro de vuelo CSV, sin editar, al punto final anterior. El contenido CSV debe enviarse bajo el parámetro csv.

Respuesta

La API devuelve JSON. Si tiene éxito, recibirá el método de verificación usado y los detalles de vuelo analizados:

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

Si el registro de vuelo no supera la verificación o la solicitud está vacía:

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

Campos de la respuesta

Zona de pruebas de la API

Pruebe la API en vivo. Hemos precargado abajo un registro de vuelo de ejemplo de un Nano V1. Haga clic en Ejecutar para verificarlo, o edite los datos para probar una verificación fallida.