Documenti API

Contratto API del sito web

Necessario solo se il tuo VA deve ancora creare l'API dello stato del volo. Il plugin stesso è gratuito; questo è un documento/un esempio di bridge.

Aut

Invia la sessione pilota di smartCARS come token al portatore. Stesso modello di autenticazione delle altre chiamate di script della comunità.

Ambito

Gli aggiornamenti di stato si applicano ai voli di linea/charter prenotati per il pilota che ha effettuato l'accesso (e alle regole VA). Il plugin 1.6+ invia anche l'arrivo + l'ETA a metà volo.

Portatore = token di sessione smartCARS dal login pilota.

Endpoint

GET  /flights/status/bookings
GET  /flights/status?kind=schedule|charter&id={id}
GET  /flights/status/history?kind=...&id=...&limit=12
GET  /flights/parkings?icao={ICAO|hub}&q={optional search}
GET  /flights/parkings/airports
POST /flights/status
{
  "kind": "schedule",
  "id": 123,
  "status": "on_time|updated|delayed|cancelled|arrived",
  "etd": "14:30",
  "eta": "16:05",
  "depParking": "Gate D 45",
  "arrParking": "Gate E 9"
}

Stati: on_time (verde), aggiornato (ambra), ritardato (rosso), cancellato (rosso), arrivato (ATA; bollotje segue il colore della partenza). eta è utile/richiesto per aggiornato/in ritardo/arrivato (nuovo ETA o ATA).

Gates / parking (plugin 1.11+)

Bookings must return origin, destination, originIcao and destinationIcao (IATA hub or ICAO). Resolve 3-letter codes via your airport registry — do not default unknown codes to a single hub. POST /flights/status accepts depParking and arrParking (empty = auto hint).

GET /flights/status/bookings → flights[]:
{
  "origin": "AMS",
  "destination": "LHR",
  "originIcao": "EHAM",
  "destinationIcao": "EGLL",
  "depParking": "Gate D 45",
  "arrParking": "Gate E 9",
  "depParkingHint": "Gate D 45",
  "arrParkingHint": "Gate E 9"
}

Parking catalog

Recommended for gate search fields in the plugin. Catalog includes passenger gates, cargo/freight, GA/FBO/private ramps — no helipads. ~90+ network airports + regional profiles for any ICAO.

GET /flights/parkings?icao=EGLL
→ { "icao": "EGLL", "known": true, "count": 100, "parkings": ["Gate A 1", "Gate B 1", "..."] }

GET /flights/parkings/airports
→ { "stats": { "airports": 95, "explicit": 80, "network": 90 }, "airports": [...] }

GET /flights/parkings/airports returns all catalog airports + stats (explicit vs generated). Unknown ICAOs receive a regional MSFS profile (Europe = Gate A/B/C/D, US = terminals, etc.).

Riferimento BlueNova: api/smartcars.php + includes/va-flight-status.php.

Esempio di bridge PHP

Esempio drop-in che puoi adattare sul tuo sito web VA se non disponi dello stack completo di BlueNova.

Scarica l'esempio di bridge PHP Registro

Prova rapida

Prenota un volo → apri VA Flight Ops in smartCARS → Aggiorna → modifica ETD/stato → Salva. Utilizza l'URL dello script della community una volta esistente l'API.

Panoramica Registro

/main>