REST и gRPC

Wink предоставляет два транспорта. Какой из них использовать, зависит от того, с каким API вы интегрируетесь.

	Транспорт	Схема	Документация
Большинство API Wink	REST поверх HTTPS	OpenAPI 3	Любая группа в разделе API в боковой панели
Partner Integrator API	gRPC поверх HTTP/2	Protocol Buffers	Partner

Генерация REST клиента

Каждая группа API публикует документ OpenAPI 3. Направьте любой генератор OpenAPI на него, и вы получите типизированного клиента на вашем языке.

# Спецификация для группы доступна рядом со страницей с её описанием.
curl -o wink-extranet.json https://api.wink.travel/v3/api-docs/extranet

npx @openapitools/openapi-generator-cli generate \
  -i wink-extranet.json -g typescript-fetch -o ./wink-client

Генераторы OpenAPI по языкам

Генерация gRPC клиента

Partner Integrator API использует gRPC. Вы генерируете клиента из схемы .proto, которую Wink публикует двумя способами:

Server reflection — сервер описывает себя, поэтому инструменты вроде grpcurl, Postman и Insomnia могут обнаружить схему во время выполнения без загрузки файлов. Для рефлексии требуется тот же bearer токен, что и для любого другого вызова.
Файлы .proto, если вы предпочитаете включить схему в проект и генерировать заранее.

# Обнаружение схемы с работающего сервера (с аутентификацией).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list

# Затем генерация клиента — здесь Go; для каждого поддерживаемого языка процесс аналогичен.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Вызовы передают ваш bearer токен в метаданных authorization, точно так же, как REST передаёт его в заголовке Authorization. Ошибки возвращаются в виде кода статуса gRPC в трейлерах ответа, а не HTTP статусом — Partner reference содержит список ожидаемых статусов.

Быстрый старт с gRPC по языкам

Что такое gRPC?

Или позвольте MCP серверу написать код

Если вы используете AI помощника для кодирования, наш MCP сервер — самый быстрый путь. Он предоставляет API Wink как инструменты, которые ваш помощник может вызывать и анализировать, так что вместо генерации целого клиента и поиска эндпоинтов вы описываете, что строите, и получаете код интеграции, адаптированный под ваш кейс.

Настроить MCP сервер Wink

Дополнительные материалы

Настройка — аккаунты, окружения и учётные данные
Аутентификация — получение и обновление токенов
Интеграция Webhook — получение событий вместо опроса