CSV Flight log verification API

Access & limitsPublic, no key needed · Upload & verify▾

Open to everyone. A free API key from your profile raises the limits: send it in an X-API-Key header, or as api_key= in the address.

	5 minutes	Hour	Day
Without a key	60	600	5,000
With a key	1,000	10,000	50,000

Every answer carries X-RateLimit-Remaining and X-RateLimit-Reset. Over a limit, the answer is error 429 with retry_after in seconds. Refused requests do not count.

Bez omezení počtu požadavků Veřejné, bez ověřování

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

POST https://www.altimetercloud.com/cz/api/csv_verify/ Parametr: csv

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:

✓ Ověřeno

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

✗ Selhalo

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

✗ Chybějící data

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

Pole odpovědi

Pole	Typ	Popis
`success`	boolean	Zda letový záznam prošel ověřením
`verify_method`	string	Metoda, která záznam ověřila: `Ed25519` (firmware 1.52+), `HMAC-SHA256` (1.50 až 1.51) nebo `SHA-256` (starší)
`log_lines`	integer	Počet datových řádků v letovém záznamu
`input_bytes`	integer	Velikost odeslaného záznamu v bajtech
`firmware`	string	Verze firmwaru z hlavičky záznamu
`hardware`	string	Revize hardwaru z hlavičky záznamu
`device_tag`	string	Štítek zařízení ze záznamu
`competitor_tag`	string	Štítek soutěžícího, pokud je přítomen (firmware 1.51+)
`apogee`	float	Maximální výška v metrech
`apogee_time`	integer	Čas apogea v milisekundách
`max_velocity`	float	Maximální rychlost stoupání v metrech za sekundu
`landing_m`	float	Výška přistání v metrech
`landing_t`	float	Čas přistání v sekundách
`flight_unique_id`	string	Hash podpisu záznamu. Předejte jej koncovému bodu Informace o letu jako `hash`. Má 128 hexadecimálních znaků pro firmware 1.52+ (Ed25519) nebo 64 pro starší záznamy
`error.code`	string	Chybový kód ve stylu HTTP (při selhání)
`error.message`	string	Čitelný popis chyby (při selhání)

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í.

Tělo POST parametr: csv

https://www.altimetercloud.com/cz/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,,

Crediting AltimeterCloud

Free to use. If you use this API, or anything made from the answers, in a commercial product or service, credit AltimeterCloud with a link to www.altimetercloud.com at the point of use: on the screen, page or printout where the data appears, for example “Data from AltimeterCloud.com”. Any credits the data's own sources ask for, listed on this page, apply as well.

Doporučené

Všechny nástroje

Cloud API