跳转到内容
Wink

REST 和 gRPC

Wink 提供两种传输方式。您使用哪种取决于您正在集成的 API。

传输方式模式文档
大多数 Wink API基于 HTTPS 的 RESTOpenAPI 3侧边栏中 API 下的任意分组
Partner Integrator API基于 HTTP/2 的 gRPCProtocol BuffersPartner

生成 REST 客户端

Section titled “生成 REST 客户端”

每个 API 分组都会发布一个 OpenAPI 3 文档。将任何 OpenAPI 生成器指向它，即可获得您所用语言的类型化客户端。

Terminal window
# 分组的规范文件与其参考页面一起提供。
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

按语言分类的 OpenAPI 生成器

生成 gRPC 客户端

Section titled “生成 gRPC 客户端”

Partner Integrator API 使用 gRPC。您可以从 Wink 以两种方式发布的 .proto 模式生成客户端：

  • 服务器反射 — 服务器自我描述，因此像 grpcurl、Postman 和 Insomnia 这样的工具可以在运行时发现模式，无需下载文件。反射需要与其他调用相同的 Bearer 令牌。
  • .proto 文件，如果您希望将模式作为依赖并提前生成。
Terminal window
# 从运行中的服务器发现模式（需认证）。
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# 然后生成客户端——这里以 Go 为例；所有支持的语言方式相同。
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

调用时会在 authorization 元数据头中携带您的 Bearer 令牌，正如 REST 在 Authorization 头中携带一样。错误以 gRPC 状态码形式出现在响应尾部，而非 HTTP 状态码——Partner 参考 列出了您应预期的状态码。

按语言分类的 gRPC 快速入门

什么是 gRPC？

或让 MCP 服务器帮您生成

Section titled “或让 MCP 服务器帮您生成”

如果您使用 AI 编码助手，我们的 MCP 服务器是最快的途径。它将 Wink 的 API 作为您的助手可以调用和推理的工具，因此您无需生成完整客户端并自行查找端点，只需描述您正在构建的内容，即可获得围绕该内容定制的集成代码。

设置 Wink MCP 服务器

进一步阅读

Section titled “进一步阅读”