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 limitu zapytań Publiczne, bez uwierzytelniania

Przegląd

Dzienniki lotu CSV tworzone przez nasze wysokościomierze zawierają kryptograficzny podpis weryfikacyjny. To API sprawdza, czy dziennik lotu jest autentyczny i dokładnie taki, jak zapisał go wysokościomierz, czy też został zmodyfikowany.

Podpis jest generowany wewnątrz wysokościomierza przez oprogramowanie szyfrowane AES-256, co czyni jego sfałszowanie obliczeniowo niewykonalnym. Oprogramowanie 1.52 i nowsze podpisuje dziennik podpisem Ed25519; starsze oprogramowanie używa skrótu opartego na SHA-256. W obu przypadkach zarówno dane lotu, jak i ustawienia nagłówka muszą pozostać niezmienione, aby przejść weryfikację.

Obecnie obsługiwany jest wysokościomierz Nano, a obsługa wszystkich urządzeń pojawi się wkrótce. Dzienniki możesz też zweryfikować za pomocą narzędzia przesyłania.

Punkt końcowy

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

Wyślij metodą POST cały dziennik lotu CSV, niezmieniony, do powyższego punktu końcowego. Treść CSV należy wysłać pod parametrem csv.

Odpowiedź

API zwraca JSON. W przypadku powodzenia otrzymasz użytą metodę weryfikacji oraz odczytane szczegóły lotu:

✓ Zweryfikowano

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

Jeśli dziennik lotu nie przejdzie weryfikacji lub żądanie jest puste:

✗ Niepowodzenie

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

✗ Brak danych

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

Pola odpowiedzi

Pole	Typ	Opis
`success`	boolean	Czy dziennik lotu przeszedł weryfikację
`verify_method`	string	Metoda, która zweryfikowała dziennik: `Ed25519` (oprogramowanie 1.52+), `HMAC-SHA256` (1.50 do 1.51) lub `SHA-256` (starsze)
`log_lines`	integer	Liczba wierszy danych w dzienniku lotu
`input_bytes`	integer	Rozmiar przesłanego dziennika w bajtach
`firmware`	string	Wersja oprogramowania z nagłówka dziennika
`hardware`	string	Wersja sprzętu z nagłówka dziennika
`device_tag`	string	Etykieta urządzenia z dziennika
`competitor_tag`	string	Etykieta zawodnika, jeśli obecna (oprogramowanie 1.51+)
`apogee`	float	Maksymalna wysokość w metrach
`apogee_time`	integer	Czas apogeum w milisekundach
`max_velocity`	float	Maksymalna prędkość wznoszenia w metrach na sekundę
`landing_m`	float	Wysokość lądowania w metrach
`landing_t`	float	Czas lądowania w sekundach
`flight_unique_id`	string	Hash podpisu dziennika. Przekaż go do punktu końcowego Informacje o locie jako `hash`. Ma 128 znaków szesnastkowych dla oprogramowania 1.52+ (Ed25519) lub 64 dla starszych dzienników
`error.code`	string	Kod błędu w stylu HTTP (w razie niepowodzenia)
`error.message`	string	Czytelny opis błędu (w razie niepowodzenia)

Środowisko testowe API

Przetestuj API na żywo. Poniżej wczytaliśmy przykładowy dziennik lotu Nano V1. Kliknij Uruchom, aby go zweryfikować, lub zmień dane, aby przetestować nieudaną weryfikację.

Treść POST parametr: csv

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

Polecane

Wszystkie narzędzia

Cloud API