XCINSIGHT · API V1

API na analýzu paraglidingových letov

Nahraj IGC, čítaj normalizované metriky, replay dáta, termiky, score, uložený weather context, AI debrief a bezpečný share stav cez verziované JSON API.

OpenAPI JSON

BASE URL

Base URL

https://xcinsight.com/api/v1

API ID letov používajú nesekvenčné ULID; interné databázové ID sa nikdy nezverejňuje.

AUTH

Autentifikácia

V Developer Platform vytvor scope API kľúč a posielaj ho ako Bearer token. Celý kľúč sa zobrazí iba raz a v databáze sa uchováva iba SHA-256 hash.

Authorization: Bearer xci_live_...

LIMITS

Rate limits

PRO obsahuje 1000 API requestov mesačne s ochranou proti zneužitiu za minútu.

DATA QUALITY

Quality metadata

Odpovede obsahujú quality metadata, keď sú dostupné, takže klient vie odlíšiť čisté dáta od filtrovaných GPS výpadkov.

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"

Podpísané webhooky

HMAC-SHA256

HTTPS endpoint zaregistruj v Developer Platform. Podpis je HMAC-SHA256 z timestamp + bodka + raw JSON body. Pred spracovaním over X-XCInsight-Timestamp a 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_...)