XCINSIGHT · API V1

API per analisi di voli in parapendio

Carica file IGC e leggi metriche normalizzate, replay, termiche, score, contesto meteo salvato, AI debrief e stato di condivisione tramite API JSON versionate.

OpenAPI JSON

BASE URL

Base URL

https://xcinsight.com/api/v1

Gli ID volo API usano ULID non sequenziali; gli ID interni del database non vengono mai esposti.

AUTH

Autenticazione

Crea una chiave con scope nella Developer Platform e inviala come Bearer token. La chiave completa viene mostrata una sola volta e nel database viene salvato solo l’hash SHA-256.

Authorization: Bearer xci_live_...

LIMITS

Rate limits

PRO include 1000 richieste API al mese con protezione anti-abuso al minuto.

DATA QUALITY

Quality metadata

Le risposte includono metadati di qualità quando disponibili, così il client può distinguere dati puliti da gap GPS filtrati.

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"

Webhook firmati

HMAC-SHA256

Registra un endpoint HTTPS nella Developer Platform. La firma usa HMAC-SHA256 su timestamp + punto + raw JSON body. Verifica X-XCInsight-Timestamp e X-XCInsight-Signature prima di elaborare.

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_...)