教程：使用 HTTP 非代理集成创建 REST API

创建 API

1. 通过以下网址登录到 Amazon API Gateway 控制台：https://console.aws.amazon.com/apigateway。

2. 如果您是第一次使用 API Gateway，您会看到一个介绍服务特征的页面。在 REST API 下，选择生成。当创建示例 API 弹出框出现时，选择确定。

   如果这不是您首次使用 API Gateway，请选择创建 API。在 REST API 下，选择生成。

3. 对于 API 名称，请输入 HTTPNonProxyAPI。

4. （可选）对于描述，输入描述。

5. 将 API 端点类型设置保留为区域。

6. 选择创建 API。

创建 /pets 资源

1. 选择创建资源。

2. 将代理资源保持为关闭状态。

3. 将资源路径保持为 /。

4. 对于资源名称，输入 pets。

5. 将 CORS（跨源资源共享）保持为关闭状态。

6. 选择创建资源。

在 /pets 资源上创建 GET 方法

1. 选择 /pets 资源。

2. 选择创建方法。

3. 对于方法类型，选择 GET。

4. 对于集成类型，选择 HTTP 集成。

5. 将 HTTP 代理集成保持为关闭状态。

6. 对于 HTTP 方法，选择 GET。

7. 对于端点 URL，输入 http://petstore-demo-endpoint.execute-api.com/petstore/pets。

   PetStore 网站可让您在给定页面上按宠物类型（例如“Dog”或“Cat”）检索 Pet 项目的列表。

8. 对于内容处理，选择传递。

9. 选择 URL 查询字符串参数。

   PetStore 网站使用 type 和 page 查询字符串参数来接受输入。您可以将查询字符串参数添加到方法请求中，并将其映射到集成请求的相应查询字符串参数中。

10. 要添加查询字符串参数，请执行以下操作：

    1. 选择添加查询字符串。

    2. 对于名称，输入 type。

    3. 保持必填和缓存为已关闭状态。

    重复上述步骤，再创建一个命名为 page 查询字符串。

11. 选择创建方法。

将输入参数映射到集成请求

1. 在集成请求选项卡的集成请求设置下，选择编辑。

2. 选择 URL 查询字符串参数，然后执行以下操作：

   1. 选择添加查询字符串参数。

   2. 对于名称，请输入 type。

   3. 对于映射自，输入 method.request.querystring.type。

   4. 将缓存保持为关闭状态。

   5. 选择添加查询字符串参数。

   6. 对于名称，请输入 page。

   7. 对于映射自，输入 method.request.querystring.page。

   8. 将缓存保持为关闭状态。

3. 选择保存。

测试 API

1. 选择测试选项卡。您可能需要选择右箭头按钮，以显示该选项卡。

2. 对于查询字符串，输入 type=Dog&page=2。

3. 选择测试。

   结果类似于以下内容：

   测试成功后，我们可以部署 API 以使其公开可用。

4. 选择部署 API。

5. 对于阶段，选择新建阶段。

6. 对于阶段名称，输入 Prod。

7. （可选）对于描述，输入描述。

8. 选择部署。

9. （可选）在阶段详细信息下，对于调用 URL，您可以选择复制图标以复制您 API 的调用 URL。您可以将此值与 Postman 和 cURL 等工具结合使用来测试您的 API。

创建 {petId} 资源

1. 选择 /pets 资源，然后选择创建资源。

2. 将代理资源保持为关闭状态。

3. 对于资源路径，选择 /pets/。

4. 对于资源名称，输入 {petId}。

   在 petId 两边使用大括号 ({ })，以便显示为 /pets/{petId}。

5. 将 CORS（跨源资源共享）保持为关闭状态。

6. 选择创建资源。

设置 GET 方法

1. 选择 /{petId} 资源，然后选择创建方法。

2. 对于方法类型，选择 GET。

3. 对于集成类型，选择 HTTP 集成。

4. 将 HTTP 代理集成保持为关闭状态。

5. 对于 HTTP 方法，选择 GET。

6. 对于端点 URL，输入 http://petstore-demo-endpoint.execute-api.com/petstore/pets/{id}。

7. 对于内容处理，选择传递。

8. 将默认超时保持为开启状态。

9. 选择创建方法。

映射 {petId} 路径参数

1. 在集成请求选项卡的集成请求设置下，选择编辑。

2. 选择 URL 路径参数。

3. API Gateway 为名为 petId 的集成请求创建路径参数，但是，此路径参数对您设置为后端集成的 HTTP 端点 URL 无效。HTTP 端点使用 {id} 作为路径参数。对于名称，删除 petId 并输入 id。

   这可将方法请求路径参数 petId 映射到集成请求路径参数 id。

4. 选择保存。

测试 方法

1. 选择测试选项卡。您可能需要选择右箭头按钮，以显示该选项卡。

2. 在 petId 的路径下，输入 4。

3. 选择 Test (测试)。

   如果成功，响应正文将显示以下内容：

   {
     "id": 4,
     "type": "bird",
     "price": 999.99
   }

部署 API

1. 选择部署 API。

2. 对于阶段，选择 Prod。

3. （可选）对于描述，输入描述。

4. 选择 Deploy (部署)。

1. 在主导航窗格中，选择阶段。

2. 在阶段详细信息下，选择复制图标以复制您 API 的调用 URL。

   它应该如下所示：

   https://my-api-id.execute-api.region-id.amazonaws.com/prod

3. 将此 URL 输入到新浏览器标签页的地址框中并在提交请求前将 /pets/4 附加到该 URL。

4. 浏览器将返回以下内容：

   {
     "id": 4,
     "type": "bird",
     "price": 999.99
   }