Documentos API

Contrato de API del sitio web

Solo es necesario si su VA aún tiene que crear la API de estado de vuelo. El complemento en sí es gratuito; Estos son documentos/una muestra de puente.

autenticación

Enviar la sesión piloto de smartCARS como token de portador. El mismo modelo de autenticación que otras llamadas de script comunitario.

Alcance

Las actualizaciones de estado se aplican a los vuelos programados/chárter reservados para el piloto registrado (y sus reglas de VA). El complemento 1.6+ también envía llegada + ETA en pleno vuelo.

Portador = token de sesión de smartCARS del inicio de sesión del piloto.

Puntos finales

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

Estados: on_time (verde), actualizado (ámbar), retrasado (rojo), cancelado (rojo), llegado (ATA; bollotje sigue el color de salida). eta es útil/requerido para actualizaciones/retrasos/llegadas (nueva 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.).

Referencia de BlueNova: api/smartcars.php + incluye/va-flight-status.php.

Ejemplo de puente PHP

Ejemplo directo que puede adaptar en su sitio web de VA si no tiene la pila completa de BlueNova.

Descargar ejemplo de puente PHP Registro

prueba rápida

Reserve un vuelo → abra VA Flight Ops en smartCARS → Actualizar → cambiar ETD/estado → Guardar. Utiliza la URL del script de su comunidad una vez que existe la API.

Descripción general Registro

/main>