Базовый адрес
https://xn--80adgdz4bq.xn--p1ai/api/v1 — JSON в UTF-8, даты в ISO 8601, деньги в целых рублях.
Для бизнеса
API для партнёровREST и OpenAPI 3.1
REST API всекуда.рф для агентств, партнёров и мобильных приложений: доступность и цены по дням, расчёт заказа, бронирование, центр помощи и сертификаты. Спецификация OpenAPI 3.1.
- RESTJSON, единый контракт для сайта и приложений
- OpenAPIспецификация 3.1 и интерактивная документация
- 15 минудержание мест при создании брони
Быстрый старт
Три запроса до брони
Базовый адрес, формат и аутентификация одинаковые для сайта, iOS и Android.
Документация
Спецификация и интерактивный справочник методов с примерами запросов.
Открыть /api/v1/docsopenapi.jsonАутентификация
Authorization: Bearer <token>. Токен выдаёт POST /auth/otp/verify с параметром client=ios|android. Публичные методы доступны без токена.
# 1. Свободные дни и цены экскурсии curl https://xn--80adgdz4bq.xn--p1ai/api/v1/products/12/days?from=2026-12-01&to=2026-12-31 # 2. Расчёт заказа на двух взрослых и ребёнка curl -X POST https://xn--80adgdz4bq.xn--p1ai/api/v1/quote -H "content-type: application/json" \ -d '{"productId":12,"slotId":3481,"participants":{"adult":2,"child":1}}' # 3. Удержать места на 15 минут и создать бронь curl -X POST https://xn--80adgdz4bq.xn--p1ai/api/v1/bookings -H "authorization: Bearer $TOKEN" \ -H "idempotency-key: $(uuidgen)" -H "content-type: application/json" \ -d '{"productId":12,"slotId":3481,"participants":{"adult":2,"child":1}}'
Методы
Основные методы
Полный список с параметрами и схемами ответов — в документации OpenAPI.
Доступность и цены
| Метод | Адрес | Что делает |
|---|---|---|
| GET | /products/{id}/days?from=&to= | Дни календаря: цена в ячейке, статус (есть места, мало, нет мест), двойные монетки |
| GET | /products/{id}/slots?date=YYYY-MM-DD | Слоты дня: время, свободные места, цена |
| GET | /products/{id}/departures | Заезды многодневного тура |
| POST | /quote | Расчёт: итог, предоплата 15% / 25%, монетки, точная дата бесплатной отмены |
Бронирование
| Метод | Адрес | Что делает |
|---|---|---|
| POST | /bookings | Удержать места на 15 минут и создать бронь (заголовок idempotency-key обязателен) |
| PATCH | /bookings/{id} | Участники и контакты ведущего группы |
| POST | /bookings/{id}/pay | Перейти к оплате: ссылка на страницу банка |
| GET | /bookings/{id}/cancel-preview | Сколько вернётся при отмене прямо сейчас |
| POST | /bookings/{id}/cancel | Отменить бронь по правилам · нужен токен или доступ к брони |
| GET | /bookings/{id}/ics | Событие в календарь (iCalendar) |
Аккаунт, помощь и сертификаты
| Метод | Адрес | Что делает |
|---|---|---|
| POST | /auth/otp/request | Запросить SMS-код на номер телефона |
| POST | /auth/otp/verify | Подтвердить код; с client=ios|android в ответе токен для Bearer |
| GET | /help/search?q= | Поиск по вопросам центра помощи |
| GET | /certificates/{code}/balance | Остаток и срок действия подарочного сертификата |
| GET | /geo/suggest?q= | Подсказки «Куда?»: города, регионы, места |
Лимиты
До 600 запросов в минуту с адреса, на создание броней — до 60 в минуту. При превышении ответ 429 и заголовок Retry-After.
Ошибки
Единый формат: { error: { code, message, details } }. Сообщения на русском, поля формы — в details.fields.
Оплата
Данные карт к нам не попадают: гость платит на странице банка, вы получаете статус платежа и брони.
Заявка
Начать работу
Расскажите о себе, менеджер отдела партнёрств пришлёт условия и договор.
- Лимиты запросов под ваш объём по договору
- Песочница оплаты для тестовых броней
- Идемпотентные запросы: повтор не создаст вторую бронь
- Технический контакт на время интеграции