第 1 章 操作 APIcast


本节论述了在使用高级 APIcast 配置时需要考虑的概念。

1.1. 公共基础 URL

公共基础 URL 是开发人员用来向 API 产品发出请求的 URL,该产品可通过 3scale 公开。这将是您的 APIcast 实例的 URL。

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

注意

您指定的公共基本 URL 必须使用 OpenShift 集群中可用的端口。默认情况下,OpenShift 路由器仅侦听标准 HTTP 和 HTTPS 端口(80 和 443)上的连接。如果您希望用户通过某些其他端口连接到您的 API,请与您的 OpenShift 管理员合作以启用该端口。

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

curl "https://echo-api.3scale.net:443/hello?user_key=YOUR_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 将基于主机名路由请求。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.