XCINSIGHT · API V1

API do analizy lotów paralotniowych

Wysyłaj pliki IGC i odczytuj znormalizowane metryki lotu, replay, termiki, score, zapisany kontekst pogody, AI debrief i stan udostępniania przez wersjonowane JSON API.

OpenAPI JSON

BASE URL

Base URL

https://xcinsight.com/api/v1

ID lotów API używają niesekwencyjnych ULID; wewnętrzne ID bazy nie są ujawniane.

AUTH

Uwierzytelnianie

Utwórz klucz z zakresami w Platformie deweloperskiej i wysyłaj go jako Bearer token. Pełny klucz jest pokazywany raz, a w bazie zapisujemy tylko hash SHA-256.

Authorization: Bearer xci_live_...

LIMITS

Rate limits

PRO zawiera 1000 żądań API miesięcznie z ochroną limitu minutowego.

DATA QUALITY

Quality metadata

Odpowiedzi zawierają metadane jakości, gdy są dostępne, aby klient odróżnił czyste dane od odfiltrowanych przerw GPS.

API v1 endpoints

JSON

GET/meprofile:read

GET/usage—

GET/flightsflights:read

POST/flightsflights:write

GET/flights/{id}flights:read

GET/flights/{id}/trackflights:read

GET/flights/{id}/thermalsanalysis:read

GET/flights/{id}/scoreanalysis:read

GET/flights/{id}/weatherweather:read

GET/flights/{id}/analysisanalysis:read

POST/flights/{id}/analysisanalysis:write

POST/flights/{id}/sharingsharing:write

DELETE/flights/{id}/sharingsharing:write

Example

cURL

curl https://xcinsight.com/api/v1/flights \
  -H "Authorization: Bearer xci_live_YOUR_TOKEN"

Podpisane webhooki

HMAC-SHA256

Zarejestruj endpoint HTTPS w Platformie deweloperskiej. Podpis to HMAC-SHA256 z timestamp + kropka + surowe JSON body. Przed przetwarzaniem zweryfikuj X-XCInsight-Timestamp i X-XCInsight-Signature.

X-XCInsight-Event: flight.analysis.completed
X-XCInsight-Delivery: dlv_...
X-XCInsight-Timestamp: 1788345000
X-XCInsight-Signature: v1=...

signature = HMAC_SHA256(timestamp + "." + raw_body, whsec_...)