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

GET /api/v1/rating/weeks/{week_id}

Таблица рейтинга авиакомпаний за выбранную завершённую неделю.

Нюансы

  • Неделя должна быть уже подведена; иначе ответ будет «не найдено».

Авторизация

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

Параметры

Authorization string header

Bearer <access_token>

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

ID недели из /rating/weeks

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

Примеры

Пример запроса 
curl 'https://panel.aeronation.ru/api/v1/rating/weeks/17' \
  -H 'Authorization: Bearer ACCESS_TOKEN'
Пример ответа 
HTTP/1.1 200 OK
{
  "id": 17,
  "label": "27.02.2024 — 04.03.2024",
  "week_start_msk": "2024-02-27",
  "week_end_msk": "2024-03-04",
  "companies": [
    {
      "id": 42,
      "name": "Aero Example",
      "short_name": "AE",
      "avatar_url": "https://…",
      "total_score": 1842.5,
      "rank": 1,
      "delta": 2
    }
  ]
}

Ошибки

unauthorized HTTP 401

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

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

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

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

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

{
  "detail": "rate_limit_exceeded"
}
not_found HTTP 404

Неделя не найдена или ещё не финализирована

Пример ошибки
HTTP/1.1 404 Not Found
{
  "detail": "not_found"
}

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