Документация по API

Контракт API веб-сайта

Требуется только в том случае, если вашему виртуальному устройству еще предстоит создать API статуса полета. Сам плагин бесплатный; это документы/образец моста.

Авторизация

Отправьте пилотный сеанс smartCARS в качестве токена на предъявителя. Та же модель аутентификации, что и другие вызовы сценариев сообщества.

Объем

Обновления статуса применяются к забронированным регулярным/чартерным рейсам для вошедшего в систему пилота (и ваших правил VA). Плагин 1.6+ также отправляет сообщение о прибытии и расчетном времени полета.

Носитель = токен сеанса smartCARS из логина пилота.

Конечные точки

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

Статусы: on_time (зеленый), обновленный (желтый), задержанный (красный), отмененный (красный), прибывший (ATA; цвет соответствует цвету отправления). eta полезна/требуется для обновленных/отложенных/прибывших (новое ETA или 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: api/smartcars.php + include/va-flight-status.php.

Пример PHP-моста

Встраиваемый пример, который вы можете адаптировать на своем веб-сайте VA, если у вас нет полного стека BlueNova.

Скачать пример моста PHP Зарегистрироваться

Быстрый тест

Забронируйте рейс → откройте VA Flight Ops в smartCARS → Обновить → измените ETD/статус → Сохранить. Использует URL-адрес сценария вашего сообщества, как только API существует.

Обзор Зарегистрироваться

/main>