Lewati ke konten
Wink

REST dan gRPC

Wink menyediakan dua transportasi. Mana yang Anda gunakan tergantung pada API mana yang Anda integrasikan.

TransportasiSkemaDokumen
Sebagian besar API WinkREST melalui HTTPSOpenAPI 3Grup mana pun di bawah API di sidebar
Partner Integrator APIgRPC melalui HTTP/2Protocol BuffersPartner

Hasilkan klien REST

Section titled “Hasilkan klien REST”

Setiap grup API menerbitkan dokumen OpenAPI 3. Arahkan generator OpenAPI apa pun ke dokumen tersebut dan Anda akan mendapatkan klien bertipe dalam bahasa Anda.

Terminal window
# Spesifikasi untuk sebuah grup disajikan di samping halaman referensinya.
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

Generator OpenAPI berdasarkan bahasa

Hasilkan klien gRPC

Section titled “Hasilkan klien gRPC”

Partner Integrator API menggunakan gRPC. Anda menghasilkan klien dari skema .proto, yang Wink terbitkan dengan dua cara:

  • Server reflection — server mendeskripsikan dirinya sendiri, sehingga alat seperti grpcurl, Postman, dan Insomnia dapat menemukan skema saat runtime tanpa perlu mengunduh file. Reflection memerlukan token bearer yang sama seperti panggilan lainnya.
  • File .proto, jika Anda lebih suka menyertakan skema dan menghasilkan klien sebelumnya.
Terminal window
# Temukan skema dari server yang berjalan (terautentikasi).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Kemudian hasilkan klien — di sini Go; setiap bahasa yang didukung bekerja dengan cara yang sama.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Panggilan membawa token bearer Anda di header metadata authorization, persis seperti REST membawa di header Authorization. Kesalahan muncul sebagai kode status gRPC di trailer respons, bukan sebagai kode status HTTP — referensi Partner mencantumkan status yang harus Anda harapkan.

Mulai cepat gRPC berdasarkan bahasa

Apa itu gRPC?

Atau biarkan server MCP menulisnya

Section titled “Atau biarkan server MCP menulisnya”

Jika Anda menggunakan asisten pengkodean AI, server MCP kami adalah jalur tercepat. Server ini menyediakan API Wink sebagai alat yang dapat dipanggil dan dianalisis oleh asisten Anda, sehingga alih-alih menghasilkan seluruh klien dan mencari endpoint sendiri, Anda cukup mendeskripsikan apa yang Anda bangun dan mendapatkan kode integrasi yang disesuaikan.

Siapkan server MCP Wink

Bacaan lebih lanjut

Section titled “Bacaan lebih lanjut”