CSV Flight log verification API

Sem limite de taxa Público, sem autenticação

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

POST https://www.altimetercloud.com/pt/api/csv_verify/ Parâmetro: csv

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:

✓ Verificado

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

✗ Falhou

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

✗ Dados em falta

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

Campos da resposta

Campo	Tipo	Descrição
`success`	boolean	Se o registo de voo passou na verificação
`verify_method`	string	Método que verificou o registo: `Ed25519` (firmware 1.52+), `HMAC-SHA256` (1.50 a 1.51) ou `SHA-256` (mais antigo)
`log_lines`	integer	Número de linhas de dados no registo de voo
`input_bytes`	integer	Tamanho do registo submetido em bytes
`firmware`	string	Versão do firmware a partir do cabeçalho do registo
`hardware`	string	Revisão de hardware a partir do cabeçalho do registo
`device_tag`	string	A etiqueta do dispositivo a partir do registo
`competitor_tag`	string	A etiqueta de concorrente, se presente (firmware 1.51+)
`apogee`	float	Altitude máxima em metros
`apogee_time`	integer	Momento do apogeu em milissegundos
`max_velocity`	float	Velocidade máxima de subida em metros por segundo
`landing_m`	float	Altura de aterragem em metros
`landing_t`	float	Hora de aterragem em segundos
`flight_unique_id`	string	O hash de assinatura do registo. Passe-o ao ponto final Informações de voo como `hash`. Tem 128 carateres hexadecimais para firmware 1.52+ (Ed25519), ou 64 para registos mais antigos
`error.code`	string	Código de erro ao estilo HTTP (em caso de falha)
`error.message`	string	Descrição de erro legível (em caso de falha)

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.

Corpo POST parâmetro: csv

https://www.altimetercloud.com/pt/api/csv_verify/

Apogee meters,2.54,,Landing meters,0.784,,
Apogee time,0.826,,Landing time,2.253,
Device tag,MyNano,,Max velocity up,5.910,
Serial number,1051-dbec-747c,,Landing velocity,4.017,
Average samples/second,49.09,,Adjusted log,no,
Settings string,fp=1010.00&ld=1&os=8&ii=7&kf=2&sr=1&rs=1&mp=1&sl=0&ms=35000&ut=0&ft=16.00&rcp=80.16795&rmi=369561,,Orig_pressure,1010.00,
Use sensor temperature,0,,Orig_static_temp,16.00,
Static temperature,16.00,
Forecast pressure,1010.00,
Firmware, 1.43b,
Hardware, Revision: 2,
Board temperature, start=22.41&end=23.27,
Battery, start=4.07&end=4.07,
Verification hash,e1eb3e800d780a0b69670f03a88e2f45c592b6e79065fc08cf83241530a60c5a,

Time(ms),Altitude(m),Pressure(hPa),Velocity(m/s),Board temp(C)
-6063,-0.008,1000.471161,0.00,,
-6042,-0.008,1000.471229,0.00,,
-6022,-0.009,1000.471274,0.00,,
-6001,-0.009,1000.471325,0.00,,
-5980,-0.009,1000.471372,0.00,,
-5960,-0.010,1000.471398,0.00,,
-5939,-0.010,1000.471401,0.00,,
-5919,-0.010,1000.471417,0.00,,
-5898,-0.010,1000.471414,0.00,,
-5878,-0.010,1000.471428,0.00,,
-5857,-0.010,1000.471465,-0.00,,
-5836,-0.010,1000.471485,-0.00,,
-5816,-0.011,1000.471500,-0.00,,
-5795,-0.011,1000.471501,-0.00,,
-5774,-0.010,1000.471484,-0.00,,
-5754,-0.010,1000.471468,0.00,,
-5733,-0.010,1000.471460,0.00,,
-5712,-0.010,1000.471442,0.00,,
-5691,-0.010,1000.471386,0.00,,
-5671,-0.009,1000.471372,0.00,,
-5645,-0.009,1000.471366,0.01,,
-5624,-0.010,1000.471375,0.01,,
-5603,-0.010,1000.471386,0.01,,
-5583,-0.009,1000.471346,0.01,,
-5562,-0.009,1000.471305,0.01,,
-5541,-0.009,1000.471281,0.01,,
-5520,-0.008,1000.471232,0.01,,
-5499,-0.008,1000.471175,0.01,,
-5478,-0.008,1000.471146,0.01,,
-5458,-0.008,1000.471157,0.01,,
826,2.537,1000.169783,0.07,,
846,2.533,1000.170257,-0.10,,
866,2.525,1000.171134,-0.26,,
886,2.514,1000.172513,-0.42,,
906,2.498,1000.174380,-0.57,,
927,2.477,1000.176799,-0.72,,
947,2.450,1000.180030,-0.87,,
967,2.420,1000.183646,-1.00,,
987,2.389,1000.187315,-1.13,,
1007,2.356,1000.191172,-1.25,,
10681,0.742,1000.382248,0.02,,
10702,0.742,1000.382222,0.02,,
10723,0.742,1000.382248,0.02,,

API Cloud

Introdução Verificação CSV Info de voo API de envio Pesquisa