Перейти до вмісту
Wink

REST та gRPC

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

ТранспортСхемаДокументація
Більшість API WinkREST через HTTPSOpenAPI 3Будь-яка група в розділі API в сайдбарі
Partner Integrator APIgRPC через HTTP/2Protocol BuffersPartner

Згенеруйте REST клієнта

Section titled “Згенеруйте REST клієнта”

Кожна група API публікує документ OpenAPI 3. Вкажіть будь-якому генератору OpenAPI цей документ, і ви отримаєте типізованого клієнта на вашій мові.

Terminal window
# Специфікація для групи доступна поруч зі сторінкою з документацією.
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 клієнта

Section titled “Згенеруйте gRPC клієнта”

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

  • Server reflection — сервер описує себе, тому інструменти на кшталт grpcurl, Postman та Insomnia можуть дізнатися схему під час виконання без необхідності завантажувати файли. Reflection вимагає того ж токена доступу, що й будь-який інший виклик.
  • Файли .proto, якщо ви хочете додати схему у свій проект і згенерувати клієнта заздалегідь.
Terminal window
# Дізнатися схему з працюючого сервера (з автентифікацією).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Потім згенерувати клієнта — тут Go; для кожної підтримуваної мови це працює однаково.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Виклики передають ваш токен у метаданих заголовка authorization, так само як REST передає його в заголовку Authorization. Помилки повертаються у вигляді коду статусу gRPC у трейлерах відповіді, а не як HTTP статус — у Partner reference наведено коди статусів, які слід очікувати.

Швидкий старт з gRPC за мовами програмування

Що таке gRPC?

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

Section titled “Або дозвольте MCP серверу написати код”

Якщо ви користуєтеся AI-помічником для кодування, наш MCP сервер — найшвидший шлях. Він надає API Wink як інструменти, які ваш помічник може викликати та аналізувати, тож замість того, щоб генерувати повного клієнта і шукати кінцеві точки самостійно, ви описуєте, що створюєте, і отримуєте код інтеграції, адаптований під це.

Налаштувати MCP сервер Wink

Додаткова література

Section titled “Додаткова література”