CSV Flight log verification API

Visão geral

Os registos de voo CSV produzidos pelos nossos altímetros incluem uma assinatura de verificação criptográfica. Esta API verifica se um registo de voo é autêntico e exatamente como foi escrito pelo altímetro, ou se foi modificado.

A assinatura é gerada dentro do altímetro por firmware cifrado com AES-256, tornando a sua falsificação computacionalmente inviável. O firmware 1.52 e posterior assina o registo com uma assinatura Ed25519; o firmware mais antigo usa um hash baseado em SHA-256. Em ambos os casos, tanto os dados de voo como as definições do cabeçalho têm de permanecer inalterados para passar na verificação.

Atualmente suporta o altímetro Nano, com suporte para todos os dispositivos em breve. Também pode verificar registos com a ferramenta de envio.

Ponto final

Envie por POST todo o registo de voo CSV, sem edições, para o ponto final acima. O conteúdo CSV deve ser enviado sob o parâmetro csv.

Resposta

A API devolve JSON. Em caso de sucesso, recebe o método de verificação usado e os detalhes do voo analisados:

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

Se o registo de voo não passar na verificação ou o pedido estiver vazio:

{
  "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 da resposta

Zona de testes da API

Teste a API ao vivo. Pré-carregámos abaixo um registo de voo de exemplo de um Nano V1. Clique em Executar para o verificar, ou edite os dados para testar uma verificação falhada.