2.6. 3scale API 管理 APIcast API 网关的高级操作简介

公共基本 URL 是您的 API 客户用来向 API 产品发出请求的 URL，该产品可通过 3scale 公开。这将是您的 APIcast 实例的 URL。

如果您使用自助管理部署选项之一，您可以在您管理的域名上为提供的每个环境（登台和生产）选择自己的公共基本 URL。这个 URL 应该与您 API 后端的 URL 不同，可能类似 https://api.yourdomain.com:443，其中 yourdomain.com 是属于您的域。设置公共基础 URL 后，请确保保存更改，如有必要，将暂存中的更改提升到生产。

APIcast 仅接受对公共基础 URL 中指定的主机名的调用。例如，如果您将 https://echo-api.3scale.net:443 指定为公共基本 URL，则正确的调用将是：

curl "https://echo-api.3scale.net:443/hello?user_key=you_user_key"

如果您的 API 没有公共域，您可以在请求中使用 APIcast IP 地址，但您仍需要在公共基础 URL 字段中指定一个值，即使该域不是真实的。在这种情况下，请确保在 Host 标头中提供主机。例如：

curl "http://192.0.2.12:80/hello?user_key=your_user_key" -H "Host: echo-api.3scale.net"

如果要在本地机器上部署，您可以将"localhost"指定为域，因此公共基本 URL 类似 http://localhost:80，然后您可以发出类似如下的请求：

curl "http://localhost:80/hello?user_key=your_user_key"

如果您有多个 API 产品，请为每个产品设置适当的公共基础 URL。APIcast 根据主机名路由请求。

根据对 API 的请求，映射规则定义指标或指定您要捕获 API 使用情况的方法。以下是映射规则的示例：

此规则意味着，任何以 / 开头的 GET 请求都以 1 为指标 hits 的增量。此规则匹配到您的 API 的任何请求。虽然这是有效的映射规则，但它太通用，如果您添加了更具体的映射规则，则通常会导致被双倍计数。

Echo API 的以下映射规则显示更为具体的示例：

映射规则在 API 产品和 API 后端级别上工作。

现在，假设有一个名为 Tools For Devs 的其他产品，它使用相同的 Echo API 后端。

(get) /path/to/example/search
(get) /path/to/example/{id}

规则 /path/to/example/search 可以标记为 Last?，然后在调用 (get)/path/to/example/search 后，APIcast 停止处理，且不会在剩余的规则中搜索匹配项，规则 (get)/path/to/example/{id} 的指标将不会被递增。

有些特殊情形需要自定义 APIcast 配置，以便 API 用户能够成功调用 API。

要避免这个问题，您可以在 Authentication Settings 的 Host Header 字段中定义 API 产品所需的主机： [Your_product_name] > Integration > Settings。

其结果是托管 APIcast 实例会在请求调用中重写主机规格。