Przejdź do głównej zawartości
Wink

REST i gRPC

Wink udostępnia dwa transporty. Którego użyjesz, zależy od tego, z którym API się integrujesz.

TransportSchematDokumentacja
Większość API WinkREST przez HTTPSOpenAPI 3Każda grupa pod API w pasku bocznym
Partner Integrator APIgRPC przez HTTP/2Protocol BuffersPartner

Generowanie klienta REST

Dział zatytułowany „Generowanie klienta REST”

Każda grupa API publikuje dokument OpenAPI 3. Wskaż na niego dowolny generator OpenAPI, a otrzymasz typowanego klienta w swoim języku.

Okno terminala
# Specyfikacja dla grupy jest dostępna obok jej strony referencyjnej.
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

Generatory OpenAPI według języka

Generowanie klienta gRPC

Dział zatytułowany „Generowanie klienta gRPC”

Partner Integrator API to gRPC. Generujesz klienta ze schematu .proto, który Wink publikuje na dwa sposoby:

  • Odbicie serwera (server reflection) — serwer opisuje sam siebie, więc narzędzia takie jak grpcurl, Postman i Insomnia mogą odkryć schemat w czasie działania bez konieczności pobierania plików. Odbicie wymaga tego samego tokena bearer co każde inne wywołanie.
  • Pliki .proto, jeśli wolisz mieć schemat lokalnie i generować klienta z wyprzedzeniem.
Okno terminala
# Odkryj schemat z działającego serwera (z uwierzytelnieniem).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Następnie wygeneruj klienta — tutaj Go; każdy obsługiwany język działa tak samo.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Wywołania przesyłają Twój token bearer w nagłówku metadanych authorization, dokładnie tak jak REST przesyła go w nagłówku Authorization. Błędy pojawiają się jako kod statusu gRPC w trailerach odpowiedzi, a nie jako kod statusu HTTP — referencja Partnera wymienia statusy, których powinieneś się spodziewać.

Szybkie starty gRPC według języka

Czym jest gRPC?

Lub pozwól serwerowi MCP napisać to za Ciebie

Dział zatytułowany „Lub pozwól serwerowi MCP napisać to za Ciebie”

Jeśli korzystasz z asystenta kodowania AI, nasz serwer MCP to najszybsza droga. Udostępnia API Wink jako narzędzia, które Twój asystent może wywoływać i analizować, więc zamiast generować całego klienta i samodzielnie szukać punktów końcowych, opisujesz, co budujesz i otrzymujesz kod integracyjny dopasowany do tego.

Skonfiguruj serwer MCP Wink

Dalsza lektura

Dział zatytułowany „Dalsza lektura”