Documents sur l'API

Contrat API de site Web

Nécessaire uniquement si votre VA doit encore créer l'API de statut de vol. Le plugin lui-même est gratuit ; ceci est de la documentation/un exemple de pont.

Authentification

Envoyez la session pilote smartCARS en tant que jeton Bearer. Même modèle d'authentification que les autres appels de script de communauté.

Portée

Les mises à jour de statut s'appliquent aux vols programmés/affrètés réservés pour le pilote connecté (et à vos règles VA). Le plugin 1.6+ envoie également l'arrivée + ETA à mi-vol.

Bearer = jeton de session smartCARS issu de la connexion du pilote.

Points de terminaison

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

Statuts : on_time (vert), mis à jour (orange), retardé (rouge), annulé (rouge), arrivé (ATA ; le bollotje suit la couleur de départ). eta est utile/requis pour les mises à jour/retardés/arrivés (nouvel ETA ou 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.).

Référence BlueNova : api/smartcars.php + include/va-flight-status.php.

Exemple de pont PHP

Exemple d'installation que vous pouvez adapter sur votre site Web VA si vous ne disposez pas de la pile complète de BlueNova.

Télécharger un exemple de pont PHP Registre

Test rapide

Réserver un vol → ouvrir VA Flight Ops dans smartCARS → Actualiser → modifier l'ETD/le statut → Enregistrer. Utilise l'URL de votre script de communauté une fois que l'API existe.

Aperçu Registre

/main>