Партнёрский API

Партнёрский API Wink — это аутентифицированный, высокопроизводительный способ для интеграторов запрашивать бронируемый туристический инвентарь — тот же самый запас, который используется в наших встраиваемых виджетах и публичных эндпоинтах для просмотра, представленный как полноценный программный интерфейс. В то время как бесплатные Web Components и публичные эндпоинты предназначены для лёгкого встраивания, ориентированного на человека, Партнёрский API создан для систем, которые ищут, оценивают и бронируют в больших объёмах. Доступ аутентифицируется для каждого интегратора и тарифицируется по использованию, поэтому вы платите только за тот трафик, который действительно отправляете.

Тарифы и цены

Один вызов API = один запрос. Учёт использования тарифицируется за каждые 1 000 запросов.

	Бесплатно	Платно	Корпоративный
Цена	$0	По использованию	Свяжитесь с нами
Лучше всего подходит для	Оценка и интеграции с низким объёмом	Оплата по факту при масштабном использовании	Индивидуальный объём и согласованные условия
Запросов в минуту	30 (всплеск до 60)	Неограниченно	Неограниченно
Запросов в месяц	10 000	Неограниченно	Неограниченно
Время отклика API (P95)	—	Менее 500 мс	Менее 500 мс
Цена за 1 000 запросов	Бесплатно	$1.00	Индивидуально
Перерасход look-to-book (за каждые 1 000 превышающих 5 000:1 просмотров)	—	$2.00	Индивидуально
Ответ при превышении лимита	429 (пауза / жёсткая остановка на месяц)	Нет	Нет
Соглашение об уровне обслуживания	—	✓	✓
Приоритетная поддержка	—	✓	✓
Индивидуальное внедрение	—	—	✓

Получить API-ключ · Начать тарификацию по использованию · Связаться с отделом продаж

Справочник API

Два интерфейса обслуживают бронируемый инвентарь и соответствуют двум вышеуказанным уровням:

Бесплатный — Consumer / Booking Engine API (REST, /api/public/**): анонимный, ориентирован на браузер и виджеты. Просмотреть справочник Booking Engine →
Платный — Partner Integrator API (gRPC, wink.partner.v1): аутентифицированный, с учётом использования, создан для интеграции сервер-сервер в масштабе. Просмотреть справочник Integrator →

Partner Integrator API использует gRPC, а не REST. Вы вызываете его с помощью сгенерированного клиента по HTTP/2 на partner.wink.travel:443, передавая токен Bearer и аккаунт, для которого выполняется вызов:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

Вышеуказанная страница справочника документирует каждый сервис, сообщение и статус ошибки, а схема также доступна во время выполнения через серверное отражение, поэтому grpcurl, Postman и Insomnia обнаруживают её без необходимости скачивания.

Если вы предпочитаете сгенерировать клиента заранее, исходные файлы .proto опубликованы на github.com/wink-travel/partner-api-proto.

Как работают использование и лимиты

Бесплатный уровень

Бесплатный уровень предназначен для того, чтобы вы могли создавать, тестировать и запускать умеренный производственный трафик без затрат.

Лимит запросов — 30 запросов в минуту с возможностью всплеска до 60 запросов. Кратковременные пики выше устойчивой скорости покрываются за счёт всплеска. Если вы превысите его, API ответит HTTP 429 (Слишком много запросов) и применит пятиминутную паузу, прежде чем ваш ключ возобновит обработку трафика. Отступите и повторите попытку после паузы, а не нагружайте эндпоинт.
Месячная квота — 10 000 запросов в календарном месяце. После достижения месячного лимита API возвращает HTTP 429 до конца месяца — жёсткая остановка — вместе с сообщением с предложением перейти на платный уровень для продолжения. Счётчик сбрасывается в начале следующего календарного месяца.

Бесплатный уровень не включает Соглашение об уровне обслуживания и приоритетную поддержку.

Платный уровень

Платный уровень снимает месячный лимит и паузы по лимиту запросов, и вы платите только за фактическое использование.

Учёт запросов — $1.00 за 1 000 запросов. Нет месячного лимита запросов и нет ограничения скорости при нормальном использовании; вы оплачиваете фактический объём.
Перерасход look-to-book — $2.00 за 1 000 превышающих просмотров. Чтобы поддерживать качество предложения, мы учитываем соотношение поисков (“просмотров”) к подтверждённым бронированиям. Вам предоставляется 5 000 просмотров на одно бронирование до применения перерасхода. Избыточные просмотры считаются по формуле:

excess = max(0, looks − bookings × 5,000)

Перерасход тарифицируется по $2.00 за 1 000 избыточных просмотров. Интеграции с хорошей конверсией редко имеют перерасход; плата применяется только к трафику, который ищет значительно больше, чем бронирует.

Платный уровень включает Соглашение об уровне обслуживания, описанное ниже — обязательство по времени безотказной работы 99,9% и целевое время отклика P95 менее 500 мс — а также приоритетную поддержку с учётом степени серьёзности.

Соглашение об уровне обслуживания

Дата вступления в силу: 5 июля 2026 · Версия 1.0

Это Соглашение об уровне обслуживания (далее “SLA”) устанавливает обязательства по доступности, сервисные кредиты и цели поддержки, которые Wink (“Wink”, “мы”, “нас”) предоставляет клиенту (“Клиент”, “вы”) для аутентифицированного Партнёрского API Wink (далее “Партнёрский API” или “Сервис”) на уровнях, для которых указано применение SLA. Это SLA является частью и регулируется соглашением между вами и Wink, в рамках которого вы получаете доступ к Партнёрскому API (далее “Соглашение”), и действует до тех пор, пока у вас есть активная, оплаченная подписка на Партнёрский API в хорошем статусе. Термины с заглавной буквы, не определённые здесь, имеют значения, указанные в Соглашении.

1. Определения

“Время безотказной работы” означает периоды, в течение которых Партнёрский API доступен для приёма и успешного ответа на корректно сформированные, аутентифицированные запросы.
“Время простоя” означает любой период, измеряемый в минутах, в течение которого Партнёрский API не отвечает успешно на корректно сформированные, аутентифицированные запросы, за исключением периодов, указанных в разделе 4. Изолированные ошибки, затрагивающие незначительную часть запросов, сами по себе не считаются временем простоя.
“Процент времени безотказной работы за месяц” означает для данного календарного месяца общее количество минут в этом месяце минус общее количество минут простоя, делённое на общее количество минут в месяце, выраженное в процентах.
“Плановое обслуживание” означает запланированное обслуживание Сервиса, о котором Wink заранее уведомил в соответствии с разделом 4.
“Сервисный кредит” означает кредит, рассчитанный как процент от платы, уплаченной или подлежащей уплате вами за Партнёрский API в затронутом календарном месяце, который применяется к будущим платежам за Партнёрский API в качестве единственного и исключительного средства возмещения за несоблюдение обязательств по времени безотказной работы.
“Время отклика” означает время, прошедшее с момента получения Wink корректно сформированного, аутентифицированного запроса на границе сервиса Wink до момента начала возврата ответа, исключая время сетевой передачи и любое время на стороне клиента вне контроля Wink.

2. Обязательства по доступности и производительности

Wink приложит коммерчески разумные усилия, чтобы обеспечить доступность Партнёрского API с процентом времени безотказной работы за месяц не менее 99,9% в каждом календарном месяце срока действия (далее “Обязательство по времени безотказной работы”). Обязательство измеряется на границе сервиса Wink и исключает факторы вне разумного контроля Wink, включая описанные в разделе 4. Системы мониторинга Wink являются авторитетным источником для измерения процента времени безотказной работы и времени отклика.

Wink также ставит целью 95-й перцентиль (P95) времени отклика менее 500 миллисекунд для успешных, корректно сформированных, аутентифицированных запросов, измеряемого на границе сервиса Wink за каждый календарный месяц (далее “Цель производительности”). Цель производительности исключает факторы, описанные в разделе 4, запросы, возвращающие ошибки на уровне приложения, вызванные самим запросом, и необычно большие или сложные пакетные запросы. Цель производительности является сервисной целью; сервисные кредиты из раздела 3 применяются к несоблюдению Обязательства по времени безотказной работы и являются единственным и исключительным средством возмещения за недостатки доступности.

3. Сервисные кредиты

Если процент времени безотказной работы за месяц опускается ниже Обязательства в любом календарном месяце, вы можете претендовать на Сервисный кредит, рассчитанный как процент от платы за Партнёрский API, уплаченной или подлежащей уплате вами за этот месяц, согласно следующей шкале:

Процент времени безотказной работы за месяц	Сервисный кредит
Ниже 99,9%, но не ниже 99,0%	10%
Ниже 99,0%, но не ниже 95,0%	25%
Ниже 95,0%	50%

Подача заявки на кредит. Чтобы получить Сервисный кредит, вы должны подать письменную заявку в Wink в течение тридцати (30) дней после окончания календарного месяца, в котором произошёл сбой. Заявка должна включать даты и время каждого инцидента простоя, на который вы претендуете, а также любые доступные вам журналы или доказательства. Заявки, поданные после этого срока, не рассматриваются.
Форма кредита. Одобренные Сервисные кредиты применяются к будущим платежам за Партнёрский API и не имеют денежной стоимости. Это не возвраты и не выплачиваются наличными, за исключением случаев, предусмотренных применимым законодательством.
Максимальный кредит. Общая сумма Сервисных кредитов за любой календарный месяц не превысит 50% платы за Партнёрский API, уплаченной или подлежащей уплате вами за этот месяц.
Единственное и исключительное средство возмещения. Сервисные кредиты являются вашим единственным и исключительным средством возмещения за любое несоблюдение Wink Обязательства по времени безотказной работы или другие недостатки доступности Партнёрского API.

4. Исключения

Обязательство по времени безотказной работы и любые Сервисные кредиты не применяются, а время простоя не включает любую недоступность, приостановку, ухудшение или проблемы с производительностью, которые возникают из-за или связаны с:

Плановым обслуживанием, о котором Wink заранее уведомил, при условии, что уведомление было сделано заблаговременно через канал, который Wink обычно использует для связи с клиентами;
Форс-мажорными обстоятельствами или другими причинами вне разумного контроля Wink, включая стихийные бедствия, действия правительства, сбои в сетях или коммунальных службах, а также атаки типа отказа в обслуживании или другие злонамеренные действия;
проблемами, вызванными вашими действиями или бездействием, вашим оборудованием, программным обеспечением или сетью, либо любым сторонним сервисом, продуктом или поставщиком, не находящимся под прямым контролем Wink;
вашим злоупотреблением Сервисом или нарушением Соглашения, этого SLA, правил приемлемого использования или применимых лимитов скорости, включая трафик, который Wink разумно считает чрезмерным, автоматизированное злоупотребление или мошенничество; и
любой приостановкой или прекращением вашего доступа, осуществлённым в соответствии с Соглашением, включая приостановку за неуплату.

5. Поддержка и цели по времени отклика

Wink предоставляет поддержку Партнёрского API в стандартные рабочие часы, за исключением местных государственных праздников. Wink приложит коммерчески разумные усилия, чтобы подтвердить получение корректно поданных запросов в службу поддержки в следующие целевые сроки в зависимости от присвоенной вами степени серьёзности и подтверждённой Wink:

Степень серьёзности	Описание	Целевое время первого ответа
Sev 1 — Критическая	Партнёрский API недоступен или неработоспособен в продакшене без обходных путей.	4 часа
Sev 2 — Значительная	Значительное ухудшение или нарушение функции; существует обходной путь.	1 рабочий день
Sev 3 — Незначительная	Общие вопросы, мелкие проблемы или запросы на функции.	2 рабочих дня

Целевые сроки описывают, когда Wink стремится установить первичный контакт; это не гарантии времени решения. Приоритетная поддержка и цели по степени серьёзности применяются на уровнях, где они заявлены.

6. Данные и безопасность

Wink поддерживает коммерчески разумные административные, технические и организационные меры, направленные на защиту конфиденциальности, целостности и доступности данных, обрабатываемых через Партнёрский API, и периодически пересматривает эти меры. Обработка персональных данных Wink регулируется Политикой конфиденциальности и любыми условиями обработки данных в Соглашении. Вы несёте ответственность за безопасность своих учётных данных API, за законное использование любых полученных данных и за своевременное уведомление Wink о любом подозрении на компрометацию учётных данных.

7. Ограничение ответственности

Сервисные кредиты являются единственным и исключительным средством возмещения за любую недоступность или несоблюдение Обязательства по времени безотказной работы и предоставляются вместо любой другой ответственности, возникающей из такого несоблюдения. За исключением прямо указанных в этом SLA случаев, Партнёрский API предоставляется “как есть”. В максимально допустимой законом степени общая ответственность Wink, возникающая из или связанная с Сервисом, ограничена условиями Соглашения, и Wink не несёт ответственности за любые косвенные, случайные, специальные, последующие или штрафные убытки, а также за упущенную прибыль, доход, данные или репутацию, даже если предупреждён о возможности таких убытков.

8. Срок действия, изменения и прекращение

Это SLA действует до тех пор, пока у вас есть активная подписка на Партнёрский API на уровне, для которого заявлено применение SLA. Wink может время от времени обновлять это SLA; существенные изменения будут сообщены через канал, который Wink обычно использует для связи с клиентами, и продолжение использования Партнёрского API после вступления изменений в силу означает принятие обновлённого SLA. Это SLA автоматически прекращается при прекращении или истечении срока действия Соглашения или вашей подписки на Партнёрский API. Разделы, которые по своей природе должны сохранять силу после прекращения — включая накопленную, но не востребованную возможность получения Сервисных кредитов, ограничение ответственности и определения — сохраняют силу.