API-Dokumente

Website-API-Vertrag

Wird nur benötigt, wenn Ihr VA die Flugstatus-API noch erstellen muss. Das Plugin selbst ist kostenlos; Dies sind Dokumente / ein Bridge-Beispiel.

Auth

Senden Sie die Pilot-smartCARS-Sitzung als Bearer-Token. Gleiches Authentifizierungsmodell wie andere Community-Skriptaufrufe.

Umfang

Statusaktualisierungen gelten für gebuchte Linien-/Charterflüge für den angemeldeten Piloten (und Ihre VA-Regeln). Plugin 1.6+ sendet auch Ankunfts- und Mid-Flight-ETA.

Bearer = smartCARS-Sitzungstoken vom Piloten-Login.

Endpunkte

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

Status: on_time (grün), aktualisiert (gelb), verspätet (rot), storniert (rot), eingetroffen (ATA; Bollotje folgt der Abflugfarbe). ETA ist nützlich/erforderlich für aktualisierte/verzögerte/angekommene (neue ETA oder 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.).

BlueNova-Referenz: api/smartcars.php + Includes/va-flight-status.php.

PHP-Bridge-Beispiel

Drop-in-Beispiel, das Sie auf Ihrer VA-Website anpassen können, wenn Sie nicht über den vollständigen Stack von BlueNova verfügen.

Laden Sie das PHP-Bridge-Beispiel herunter Registrieren

Schnelltest

Einen Flug buchen → VA Flight Ops in smartCARS öffnen → Aktualisieren → ETD/Status ändern → Speichern. Verwendet die URL Ihres Community-Skripts, sobald die API vorhanden ist.

Überblick Registrieren

/main>