API docs

Website API-contract

Alleen nodig als je VA de flight-status API nog moet bouwen. De plugin zelf is gratis; dit is documentatie / bridge-voorbeeld.

Auth

Stuur de piloot smartCARS-sessie als Bearer-token. Zelfde auth-model als andere community script-calls.

Scope

Statusupdates gelden voor geboekte schedule/charter-vluchten van de ingelogde piloot (plus jullie VA-regels). Plugin 1.6+ stuurt ook arrived + mid-flight ETA. Plugin 1.11+ toont departure/arrival gates (MSFS) met searchable parking-lijsten.

Bearer = smartCARS session token van de piloot-login.

Endpoints

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

Statussen: on_time (groen), updated (oranje), delayed (rood), cancelled (rood), arrived (ATA; bolletje volgt vertrekkleur). eta is verplicht/handig bij updated/delayed/arrived (nieuwe ETA of ATA).

Gates / parking (plugin 1.11+)

Bookings moeten origin, destination, originIcao en destinationIcao teruggeven (IATA hub of ICAO). Resolve 3-letter codes via jullie luchthavenregister — niet blind naar één hub fallback. POST /flights/status accepteert depParking en arrParking (leeg = 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-catalogus

Aanbevolen voor gate-zoekvelden in de plugin. Catalog bevat passenger gates, cargo/freight, GA/FBO/private ramps — geen helipads. ~90+ netwerk-airports + regionale profielen voor elke 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 geeft alle airports in de catalog + stats (explicit vs gegenereerd). Onbekende ICAO’s krijgen een regionaal MSFS-profiel (Europa = Gate A/B/C/D, VS = terminals, etc.).

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

PHP-bridge voorbeeld

Voorbeeld dat je op je VA-website kunt aanpassen als je niet de volledige BlueNova-stack hebt.

Download PHP bridge voorbeeld Registreren

Snel testen

Boek een vlucht → open VA Flight Ops in smartCARS → Refresh → wijzig ETD/status → Save. Werkt via je community script-URL zodra de API bestaat.

Overzicht Registreren

/main>