设置

本文介绍如何快速作为开发者进行设置并开始在 Wink 上测试我们的 API。

请按照以下步骤操作：

在 Wink 上注册您的用户账户。
创建一个分销账户。您需要绑定您的应用程序。更多背景请参见什么是 Studio。
创建一个应用程序，并将其关联到步骤 2 中创建的分销账户。对于服务器到服务器的 API 集成，选择 MACHINE_2_MACHINE 作为客户端类型。
创建 Application 后，请立即复制并保存 client-id 和 secret key —— secret key 只显示一次，无法再次获取。

CDN

在 Wink，我们使用 Cloudinary 管理所有图片和视频资源。访问我们的旅游库存时，您将完全享受 Cloudinary 的所有高级功能。

我们的 cloud_name 是 traveliko。

Cloudinary

示例

对于我们支持的每种旅游库存类型，都会有一个名为 multimedias 的嵌套 JSON 数组。多媒体条目的 JSON 如下所示：

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

上面高亮的行显示了 Cloudinary 的唯一 ID partners/radisson_blu_logo。这就是您获取任意格式、质量和尺寸图片所需的全部信息。

测试

请前往我们的API部分，选择您想使用的 API。

API 文档

我们的文档站点支持直接在站内运行 API 命令。

本例中，您将使用 Search Lookups (OAuth2) API 调用。

使用Lookup API检索目的地或酒店。
在左侧导航栏点击 Authentication。
输入您的 client-id 和 client secret，点击 Get TOKEN 按钮。
如果凭证有效，您将看到 API 密钥已应用。
现在可以测试 lookup 端点。

Lookup API endpoint — *搜索 Lookups (OAuth2) 示例*

Postman

您也可以使用 Postman 完成相同操作。

下载 Postman。
在Lookup API页面顶部点击 Download OpenAPI spec。
将其导入 Postman。
如果导入为名为 Wink API 的新集合，点击集合名称旁的横向省略号（三点），选择 Edit。
在 Authorization 标签页，将 Auth type 设置为 OAuth2。
将 Add auth data to 设置为 Request headers。
将 Header prefix 设置为 Bearer。
将 Token Name 设置为您想在 Postman 中保存的令牌名称，例如 Wink Staging。
将 Grant type 设置为 Client Credentials。
将 Access token URL 设置为 https://staging-iam.wink.travel/oauth2/token。
将 Client ID 设置为您的应用生成的 Client ID。
将 Client Secret 设置为您的应用生成的 Client Secret。
将 Scope 设置为 inventory.read inventory.write inventory.remove。这些是 Wink 所需的全部权限范围。
将 Client Authentication 设置为 Send as Basic Auth header。
点击 Get New Access Token 按钮获取并保存令牌。
对 Wink API 集合下的所有 API 调用，确保认证标签页显示 Inherit auth from parent，以便每次调用都包含令牌。