İçeriğe geç
Wink

REST ve gRPC

Wink iki taşıma yöntemi sunar. Hangi yöntemi kullanacağınız, entegre olduğunuz API’ye bağlıdır.

TaşımaŞemaDokümanlar
Çoğu Wink API’siHTTPS üzerinden RESTOpenAPI 3Kenar çubuğundaki API altındaki herhangi bir grup
Partner Integrator APIHTTP/2 üzerinden gRPCProtocol BuffersPartner

Bir REST istemcisi oluşturun

Bölüm başlığı “Bir REST istemcisi oluşturun”

Her API grubu bir OpenAPI 3 dokümanı yayınlar. Herhangi bir OpenAPI oluşturucusunu buna yönlendirin ve dilinizde tiplenmiş bir istemci elde edin.

Terminal window
# Her grubun spesifikasyonu bu siteden indirilebilir: /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

Dile göre OpenAPI oluşturucuları

Bir gRPC istemcisi oluşturun

Bölüm başlığı “Bir gRPC istemcisi oluşturun”

Partner Integrator API gRPC’dir. Bir istemciyi .proto şemasından oluşturursunuz, Wink bunu iki şekilde yayınlar:

  • Sunucu yansıtması — sunucu kendini tanımlar, böylece grpcurl, Postman ve Insomnia gibi araçlar çalışma zamanında dosya indirmeden şemayı keşfedebilir. Yansıtma, diğer çağrılarla aynı taşıyıcı token gerektirir.
  • .proto dosyaları, şemayı önceden dahil etmek ve oluşturmak isterseniz.
Terminal window
# Çalışan bir sunucudan şemayı keşfedin (kimlik doğrulamalı).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Sonra bir istemci oluşturun — burada Go; desteklenen her dil aynı şekilde çalışır.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Çağrılar, taşıyıcı token’ınızı authorization meta veri başlığında taşır, tıpkı REST’in Authorization başlığında taşıması gibi. Hatalar, HTTP durum kodu yerine yanıt sonlarında gRPC durum kodu olarak gelir — Partner referansı beklemeniz gereken durumları listeler.

Dile göre gRPC hızlı başlangıçlar

gRPC nedir?

Ya da MCP sunucunun yazmasına izin verin

Bölüm başlığı “Ya da MCP sunucunun yazmasına izin verin”

Bir yapay zeka kodlama asistanı kullanıyorsanız, MCP sunucumuz en hızlı yoldur. Wink API’lerini asistanınızın çağırıp üzerinde düşünebileceği araçlar olarak sunar, böylece tüm bir istemci oluşturup uç noktaları kendiniz bulmak yerine, ne inşa ettiğinizi tanımlarsınız ve kullanım durumunuza göre şekillendirilmiş entegrasyon kodu alırsınız.

Wink MCP sunucusunu kurun

Daha fazla okuma

Bölüm başlığı “Daha fazla okuma”