API docs

Website API contract

Only needed if your VA still has to build the flight-status API. The plugin itself is free; this is docs / a bridge sample.

Auth

Send the pilot smartCARS session as Bearer token. Same auth model as other community script calls.

Scope

Status updates apply to booked schedule/charter flights for the logged-in pilot (and your VA rules). Plugin 1.6+ also sends arrived + mid-flight ETA.

Bearer = smartCARS session token from the pilot login.

Endpoints

GET  /flights/status/bookings
GET  /flights/status?kind=schedule|charter&id={id}
GET  /flights/status/history?kind=...&id=...&limit=12
POST /flights/status
{
  "kind": "schedule",
  "id": 123,
  "status": "on_time|updated|delayed|cancelled|arrived",
  "etd": "14:30",
  "eta": "16:05"
}

Statuses: on_time (green), updated (amber), delayed (red), cancelled (red), arrived (ATA; bollotje follows departure colour). eta is useful/required for updated/delayed/arrived (new ETA or ATA).

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

PHP bridge sample

Drop-in example you can adapt on your VA website if you do not have BlueNova’s full stack.

Download PHP bridge sample Register

Quick test

Book a flight → open VA Flight Ops in smartCARS → Refresh → change ETD/status → Save. Uses your community script URL once the API exists.

Overview Register

/main>