跳转到内容

应用程序

作为开发者,应用程序让您可以访问 Wink 的所有功能。您可以访问所有相同的数据,甚至扩展 Wink 自身的功能。 您可以选择使用 Wink 的 OAuth2 服务器来验证您的旅游网站,就像使用 Google 或 Facebook 一样。 这样,您就可以将 Wink 的功能扩展到您自己的网站或应用程序中。

示例应用程序
示例应用程序入口
  1. 账户中选择您想要操作的账户。
  2. 点击账户卡底部的 Actions,选择 Manage account
  3. 在接下来的页面中点击 Applications 标签。
  4. 此部分将列出您所有的应用程序。
  5. 选择编辑现有应用程序或创建新的应用程序。

由于您无法访问我们为您创建的应用程序的 secret key,您需要自己创建一个。

创建应用程序时,您需要选择一个客户端类型,该类型决定了应用程序的身份验证方式:

  • SPA(单页应用)— 适用于使用带 PKCE 的 OAuth2 授权码流程的基于浏览器的前端应用程序。这是 Web 应用程序中最常见的类型。
  • MACHINE_2_MACHINE — 适用于服务器到服务器的集成,直接使用客户端凭据进行身份验证。当您的后端服务需要在没有用户参与的情况下调用 Wink API 时使用此类型。

以下是创建应用程序的步骤:

  1. 在应用程序页面,点击 Create new application 按钮。
  2. 名称 给您的应用程序命名。例如 Cool App
  3. 客户端类型 选择 SPA 用于 Web 应用,或选择 MACHINE_2_MACHINE 用于服务器集成。
  4. 实体名称 将您的应用程序与您现有的账户之一关联。例如 Cool Account
  5. 重定向 URI 至少需要一个重定向 URI。它用于在成功身份验证后验证重定向域。例如 https://www.cool-site.com
  6. 注销后重定向 URI (可选) 用户注销后可以重定向到的 URL。这确保用户在会话结束后进入已知页面。
  7. 点击 Save 按钮继续。

您将被重定向回应用程序列表。您将在列表中看到新应用程序,并且仅此一次可以访问应用程序的密钥。请务必复制并妥善保存。

如果您的某个重定向 URI 发生变化,或者您想添加或删除 URI,您需要更新应用程序。

更新现有应用程序的步骤如下:

  1. 点击您想更新的应用程序的 Actions 链接。
  2. 点击 Actions 下的 Update 按钮。
  3. 对应用程序进行修改。
  4. 点击 Save 按钮继续。

您将被重定向回应用程序列表。

如果您不再需要某个应用程序,可以将其删除。

删除应用程序的步骤如下:

  1. 点击您想删除的应用程序的 Actions 链接。
  2. 点击 Actions 下的 Remove 按钮。
  3. 点击 OK 按钮确认删除。

您将被重定向回应用程序列表。