Большая Страна API

API URL: https://api.bolshayastrana.com/

Актуальная версия API: 1.5

API использует систему версий, для указания номера версии необходимо использовать параметр "v". Пример адреса с указанием версии https://api.bolshayastrana.com/list/destinations?v=1.4

Постраничная выборка данных

Большинство методов поддерживают постраничную выборку данных. Для этого необходимо передать GET параметры:

page - номер текущий страницы (начиная с 1)

limit - максимальное количество элементов на одной странице (максимальное значение 50, по умолчанию 20)

В случае, если номер страницы некорректный, никакая ошибка не вернется.

Если номер страницы МЕНЬШЕ 0, вернется нулевая страница
Если номер страницы БОЛЬШЕ количества страниц, вернется последняя страница

При этом, блок pagination в ответе всегда будет корректным, то есть отображать текущее состояние.

В ответах будет приходить объект pagination, который содержит информацию о постраничной выборке:

"pagination": {
    "current_page": 1,
    "total_pages": 2,
    "total_items": 30,
    "per_page": 20
}

Название	Назначение	Тип данных
current_page	Номер текущей страницы	integer
total_pages	Общее количество страниц	integer
total_items	Общее количество элементов	integer
per_page	Количество элементов на страницах	integer

Авторизация

Для работы с API необходимо передавать в HTTP запросе заголовок Authorization: Bearer <API Токен>. Для получения токена, обратитесь в Telegram t.me/mirepnikov или по почте [email protected].

Пример заголовка: