İç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
# Bir grubun spesifikasyonu, referans sayfasının yanında sunulur.
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

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 edinip 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


# Ardından 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 sunucusunun yazmasına izin verin

Bölüm başlığı “Ya da MCP sunucusunun 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ğırabileceği ve ü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”