Skip to content
Wink

REST и gRPC

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

ТранспортСхемаДокументация
Повечето Wink API-таREST през HTTPSOpenAPI 3Всяка група под API в страничната лента
Partner Integrator APIgRPC през HTTP/2Protocol BuffersPartner

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

Section titled “Генериране на REST клиент”

Всяка API група публикува OpenAPI 3 документ. Насочете всеки OpenAPI генератор към него и ще получите типизиран клиент на вашия език.

Terminal window
# Спецификацията на всяка група е за сваляне на този сайт: /api/downloads/<group>.json
curl -o wink-extranet.json https://wink.travel/api/downloads/extranet.json


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 изисква същия bearer токен като при всяко друго повикване.
  • .proto файловете, ако предпочитате да включите схемата и да генерирате предварително.
Terminal window
# Откриване на схемата от работещ сървър (с автентикация).
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 справочникът изброява статусите, които трябва да очаквате.

Бързи старти за gRPC по езици

Какво е gRPC?

Или оставете MCP сървъра да го напише

Section titled “Или оставете MCP сървъра да го напише”

Ако използвате AI помощник за кодиране, нашият MCP сървър е най-бързият път. Той излага Wink API-тата като инструменти, които вашият помощник може да извиква и анализира, така че вместо да генерирате цял клиент и да търсите ендпойнтите сами, описвате какво изграждате и получавате интеграционен код, съобразен с това.

Настройте Wink MCP сървъра

Допълнително четене

Section titled “Допълнително четене”