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

POST /api/v1/flights

Загружает снимок полётного отчёта так же, как в панели: начинается проверка, данные маршрута появятся позже.

подписка «Допуск»

Нюансы

  • Файл — изображение PNG или JPG.
  • После загрузки отчёт уходит на автоматическую и при необходимости ручную проверку.
  • Слишком частые загрузки подряд будут отклонены.

Авторизация

Нужен токен пользователя. Права: flights:write

Этот метод меняет данные: у приложения должна быть подписка «Допуск».

Тип содержимого: multipart/form-data

Параметры

Authorization string header

Bearer <access_token>

Обязательный параметр
report file form

PNG/JPG изображение отчёта

Обязательный параметр

Примеры

Пример запроса 
curl -X POST 'https://panel.aeronation.ru/api/v1/flights' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -F 'report=@./flight-report.jpg'
Пример ответа 
HTTP/1.1 200 OK
{
  "id": 9013,
  "date": "2024-03-02T10:01:00",
  "aircraft": "UNKNOWN",
  "icao_out": "",
  "icao_in": "",
  "total_ft": null,
  "en_route": null,
  "pax": null,
  "cargo_kg": null,
  "delay_min": null,
  "moderator_checked": false,
  "automated_checked": false,
  "rating_contribution": null,
  "season_points": null,
  "is_archived": false,
  "created_at": "2024-03-02T10:01:00"
}

Ошибки

unauthorized HTTP 401

Нет токена, токен просрочен или согласие отозвано

{
  "detail": "unauthorized"
}
insufficient_scope HTTP 403

У токена нет нужного права доступа

{
  "detail": "insufficient_scope"
}
rate_limit_exceeded HTTP 429

Слишком много запросов для пары приложение + пилот. Без «Допуска» — 10/мин на чтение; с подпиской — 60/мин на любые методы

{
  "detail": "rate_limit_exceeded"
}
write_not_enabled HTTP 403

У приложения нет подписки «Допуск»

missing_file HTTP 400

Не передан файл report

invalid_file HTTP 400

Разрешены только png/jpg/jpeg

too_fast HTTP 429

Слишком частая загрузка — подождите несколько секунд

Пример ошибки
HTTP/1.1 400 Bad Request
{
  "detail": "missing_file"
}

Связанные методы