Skip to content
Wink

REST dan gRPC

Wink menyediakan dua jenis pengangkutan. Yang mana satu anda gunakan bergantung pada API yang anda integrasikan.

PengangkutanSkemaDokumentasi
Kebanyakan API WinkREST melalui HTTPSOpenAPI 3Mana-mana kumpulan di bawah API dalam bar sisi
Partner Integrator APIgRPC melalui HTTP/2Protocol BuffersPartner

Jana klien REST

Section titled “Jana klien REST”

Setiap kumpulan API menerbitkan dokumen OpenAPI 3. Arahkan mana-mana penjana OpenAPI kepadanya dan anda akan mendapat klien berjenis dalam bahasa anda.

Terminal window
# Spesifikasi untuk satu kumpulan disediakan bersebelahan dengan halaman rujukannya.
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

Penjana OpenAPI mengikut bahasa

Jana klien gRPC

Section titled “Jana klien gRPC”

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

  • Server reflection — pelayan menerangkan dirinya sendiri, jadi alat seperti grpcurl, Postman dan Insomnia boleh menemui skema semasa masa jalan tanpa perlu memuat turun fail. Reflection memerlukan token bearer yang sama seperti panggilan lain.
  • Fail .proto, jika anda lebih suka menyimpan skema dan menjana terlebih dahulu.
Terminal window
# Temui skema dari pelayan yang sedang berjalan (dengan pengesahan).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Kemudian jana klien — di sini Go; setiap bahasa yang disokong berfungsi dengan cara yang sama.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Panggilan membawa token bearer anda dalam header metadata authorization, sama seperti REST membawanya dalam header Authorization. Ralat tiba sebagai kod status gRPC dalam trailer respons dan bukannya sebagai kod status HTTP — rujukan Partner menyenaraikan status yang anda harus jangkakan.

Permulaan pantas gRPC mengikut bahasa

Apakah gRPC?

Atau biarkan pelayan MCP menulisnya

Section titled “Atau biarkan pelayan MCP menulisnya”

Jika anda menggunakan pembantu pengekodan AI, pelayan MCP kami adalah laluan terpantas. Ia mendedahkan API Wink sebagai alat yang boleh dipanggil dan dianalisis oleh pembantu anda, jadi daripada menjana keseluruhan klien dan mencari titik akhir sendiri, anda hanya terangkan apa yang anda bina dan dapatkan kod integrasi yang disesuaikan mengikut itu.

Sediakan pelayan MCP Wink

Bacaan lanjut

Section titled “Bacaan lanjut”