Bỏ qua để đến nội dung
Wink

REST và gRPC

Wink cung cấp hai phương thức truyền tải. Việc bạn sử dụng phương thức nào phụ thuộc vào API bạn đang tích hợp.

Phương thức truyền tảiSchemaTài liệu
Hầu hết các API của WinkREST qua HTTPSOpenAPI 3Bất kỳ nhóm nào dưới API trong thanh bên
Partner Integrator APIgRPC qua HTTP/2Protocol BuffersPartner

Tạo client REST

Phần tiêu đề “Tạo client REST”

Mỗi nhóm API đều xuất bản một tài liệu OpenAPI 3. Chỉ cần trỏ bất kỳ công cụ tạo OpenAPI nào vào đó và bạn sẽ có một client được kiểu hóa trong ngôn ngữ của bạn.

Terminal window
# Đặc tả cho một nhóm được phục vụ bên cạnh trang tham chiếu của nó.
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

Các công cụ tạo OpenAPI theo ngôn ngữ

Tạo client gRPC

Phần tiêu đề “Tạo client gRPC”

Partner Integrator API sử dụng gRPC. Bạn tạo client từ schema .proto, mà Wink cung cấp theo hai cách:

  • Phản chiếu server — server tự mô tả, vì vậy các công cụ như grpcurl, Postman và Insomnia có thể khám phá schema khi chạy mà không cần tải file. Phản chiếu yêu cầu cùng token bearer như các cuộc gọi khác.
  • Các file .proto, nếu bạn muốn lưu schema và tạo client trước.
Terminal window
# Khám phá schema từ server đang chạy (có xác thực).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Sau đó tạo client — ví dụ Go; mọi ngôn ngữ được hỗ trợ đều tương tự.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Các cuộc gọi mang token bearer của bạn trong header metadata authorization, giống như REST mang trong header Authorization. Lỗi được trả về dưới dạng mã trạng thái gRPC trong phần trailers của phản hồi thay vì mã trạng thái HTTP — tham chiếu Partner liệt kê các trạng thái bạn nên mong đợi.

Bắt đầu nhanh với gRPC theo ngôn ngữ

gRPC là gì?

Hoặc để server MCP viết mã cho bạn

Phần tiêu đề “Hoặc để server MCP viết mã cho bạn”

Nếu bạn sử dụng trợ lý lập trình AI, server MCP của chúng tôi là con đường nhanh nhất. Nó cung cấp các API của Wink như các công cụ mà trợ lý của bạn có thể gọi và suy luận, vì vậy thay vì tạo toàn bộ client và tự tìm các endpoint, bạn chỉ cần mô tả những gì bạn đang xây dựng và nhận mã tích hợp phù hợp với điều đó.

Thiết lập server MCP của Wink

Đọc thêm

Phần tiêu đề “Đọc thêm”