并非所有 API 产品都提供沙盒功能。那些提供沙盒功能的产品在 Expedia Group 控制台产品目录中有标记。
沙盒模式
使用我们的沙盒功能安全地测试您的 API
借助我们的免费沙盒功能，您可以测试 Expedia API 产品。您在沙盒模式下所做的工作将不会反映在您的生产应用程序中，反之亦然。
借助沙盒功能，您能够：
- 以安全、无风险的方式试用支持沙盒的产品
- 创建特定于沙盒的 API 客户端
- 根据需要更新沙盒产品配置
- 使用我们的 API Explorer、Postman 或其他工具测试沙盒端点
进入沙盒模式
登录 Expedia Group 控制台并选择一个帐户。当您第一次访问沙盒功能时，我们将创建一个沙盒帐户，以镜像您用其访问沙盒功能的合作伙伴帐户。
进入沙盒模式有两种方法。
1. 使用全局切换开关
点击左下角的帐户名称，转到合作伙伴帐户菜单。
在帐户浮出控件上，点击沙盒模式切换开关以将其打开。
在沙盒模式下，您可以在不影响生产应用程序的情况下进行更改。您只能在产品目录中看到启用沙盒的产品。
当您准备恢复上线模式时，请再次“关闭”帐户浮出控件中的相应切换开关。
2. 从产品详细信息页面中试用产品
转到产品目录并找到您感兴趣的产品。启用沙盒的产品将标有徽标。
点击启用沙盒的产品的产品卡，您将进入产品详细信息页面。点击页面顶部的试用产品按钮以切换到沙盒模式并进行测试配置。
当您准备恢复上线模式时，请点击转到实时模式链接或返回到帐户浮出控件以切换全局切换开关。
在沙盒上配置产品
初始配置
在启用沙盒的产品的产品详细信息页面上，点击试用产品以在沙盒模式下启动配置。
更新
- 使用全局切换开关打开您的沙盒帐户。
- 转到您要更新的产品的产品详细信息页面。
- 打开上下文菜单（右上角的三个垂直点）并选择“更新配置”以启动配置流程。
注意：此上下文菜单也适用于您的上线帐户，因此，请务必切换到您的沙盒帐户以避免错误。您将需要使用沙盒选项来手动更新上线配置。
API 客户端创建
无论要在沙盒模式下还是在上线模式下使用 Expedia Group 旅行平台 API，您都必须创建一个或多个 API 客户端，这些客户端类似于受密码保护的用户帐户。本质上，API 客户端确定发出 API 请求的软件属于您（身份验证），并允许您限制每个客户端可以发出的 API 请求类型（授权）。创建 API 客户端有两种方法：
- 点击产品详细信息页面上的上下文菜单，然后选择创建 API 客户端。
- 点击左侧导航栏中的创建 API 客户端。
在“创建 API 客户端”页面上，输入名称和描述，以帮助您和组织中的其他人了解其中包含的产品。在可用产品列表中，选择要包含的范围（API 请求类型）。注意：选中顶层的复选框将选择所有子元素。
点击创建。
创建 API 客户端后，您将看到一个确认屏幕，其中包含您的凭据 ID 和秘钥。**这些信息仅显示一次。请务必复制凭据和秘钥并将其保存到安全位置。**不要将您的客户端 ID 或秘钥存储在可公开访问的区域，例如 GitHub、客户端代码等。
产品和范围
所有 API 客户端都在一个合作伙伴帐户中运行。当您将产品添加到帐户时，它们将可以包含在 API 客户端中。您可以创建一个 API 客户端并授予其访问一个或多个产品的权限。
每个产品都包含一组“范围”，用于授予对特定请求类型的访问权限。您分配的范围将控制该客户端被授权执行的操作。如果您有多个发出 API 请求的软件服务，我们建议您为每个服务创建一个单独的 API 客户端，并仅选择每个 API 客户端所需要的范围。
测试 API
为沙盒产品创建 API 客户端后，请转到要在 Developer Hub 中测试的产品的 API Explorer 页面。更改 API 服务器 URL 以指向沙盒并插入安全凭据。
将 API 上线
完成沙盒测试后，您可以创建上线版本的 API 客户端以在生产应用程序中使用。
- 登录控制台。
- 在产品目录中，转到您要添加的产品的产品详细信息页面。
- 点击添加产品（或者，如果产品需要批准，请点击请求添加）。
- 像在沙盒中一样配置产品。
- 点击提交。
- 创建上线版本 API 客户端：点击左侧导航栏中的创建 API 客户端。
- 通常，您将使用与沙盒相同的范围。
- 点击获取凭据。
注意：当您添加产品时，Expedia 团队可能会与您联系以获取更多信息。
您还可以请求直接在沙盒中完成上线 - 请查找转到上线模式链接。
要了解如何在软件中嵌入 API 客户端，请阅读 API 身份验证和授权。