创建一个简单的 API

本教程介绍如何创建一个简单的 API 并对其进行验证。你将完成以下步骤：

1. 创建指向 httpbin.org 的服务，并为其创建路由和上游。
2. 将服务发布到缺省网关组。
3. 使用 cURL 向代理发送 API 请求，并将请求转发到上游。

前提条件

1. 安装 API7 企业版。
2. 获取一个具有超级管理员 或 API 提供者 角色的用户账户。
3. 确保缺省网关组中至少有一个网关实例。

步骤 1：创建服务

1. 从左侧导航栏中选择服务，然后单击新增服务。
2. 选择手动新增，弹出新增服务对话框，如下所示：
3. 在新增服务对话框中，执行以下操作：
   • 在名称字段中，输入 httpbin。
   • 在上游 Scheme 字段中，选择 HTTP。
4. 单击新增。

步骤 2：创建路由

1. 单击上一步中创建的服务，然后单击添加路由。弹出新增路由对话框，如下所示：
2. 在新增路由对话框中，执行以下操作：
   • 在路由名称字段中，输入 getting-started-ip。
   • 在路径字段中，输入 /ip。
   • 在 HTTP 方法字段中，选择 GET。
3. 单击新增。

步骤 3：发布服务

1. 从左侧导航栏中选择服务，然后选择 httpbin 服务并单击立即发布。
2. 选择 缺省网关组，然后单击下一步。
3. 在弹出的对话框中，执行以下操作：
   • 在新版本字段中，输入 1.0.0。
   • 在如何找到上游字段中，选择使用节点。
4. 单击新增节点，弹出新增节点对话框，如下所示：
5. 在新增节点 对话框中，执行以下操作：
   • 在主机 字段中，输入 httpbin.org。
   • 在端口 字段中，输入 80。
   • 在权重 字段中，使用默认值 100。
6. 单击新增。
7. 确认服务信息，然后单击发布。

步骤 4：验证 API

发送 API 请求：

curl "http://127.0.0.1:9080/ip" 

你应该会看到以下输出：

{
  "origin": "127.0.0.1"
}