# 开发 API Gateway 中的 HTTP API
<a name="http-api-develop"></a>

本节提供有关开发 API Gateway API 时所需的 API Gateway 功能的详细信息。

在开发 API Gateway API 时，您可以决定 API 的许多特征。这些特征取决于 API 的使用案例。例如，您可能希望仅允许某些客户端调用您的 API，或者您可能希望它对所有人都可用。您可能需要 API 调用来执行 Lambda 函数、进行数据库查询或调用应用程序。

**Topics**
+ [创建 HTTP API](#http-api-examples)
+ [创建针对 API Gateway 中 HTTP API 的路由](http-api-develop-routes.md)
+ [API Gateway 中 HTTP API 的 IP 地址类型](http-api-ip-address-type.md)
+ [控制和管理对 API Gateway 中的 HTTP API 的访问](http-api-access-control.md)
+ [针对 API Gateway 中的 HTTP API 创建集成](http-api-develop-integrations.md)
+ [为 API Gateway 中的 HTTP API 配置 CORS](http-api-cors.md)
+ [针对 API Gateway 中的 HTTP API 转换 API 请求和响应](http-api-parameter-mapping.md)
+ [将 OpenAPI 定义用于 API Gateway 中的 HTTP API](http-api-open-api.md)

## 创建 HTTP API
<a name="http-api-examples"></a>

要创建功能 API，您必须至少有一个路由、集成、阶段和部署。

以下示例显示如何创建具有 Amazon Lambda 或 HTTP 集成、路由和默认阶段（配置为自动部署更改）的 API。

本指南以您已熟悉 API Gateway 和 Lambda 为前提。如需更详细的指南，请参阅[开始使用 API Gateway](getting-started.md)。

**Topics**
+ [使用 创建 HTTP APIAmazon Web Services 管理控制台](#apigateway-http-api-create.console)
+ [使用Amazon CLI 创建 HTTP API](#http-api-examples.cli.quick-create)

### 使用 创建 HTTP APIAmazon Web Services 管理控制台
<a name="apigateway-http-api-create.console"></a>

1. 打开 [API Gateway 控制台](https://console.amazonaws.cn/apigateway)。

1. 选择 **Create API (创建 API)**。

1. 在 **HTTP API** 下，选择 **Build (构建)**。

1. 选择 **Add integration (添加集成)**，然后选择一个 Amazon Lambda 函数或输入 HTTP 端点。

1. 对于 **Name (名称)**，输入 API 的名称。

1. 选择 **Review and create**。

1. 选择**创建**。

现在，您的 API 已准备好，可进行调用。您可以通过在浏览器中输入其调用 URL 或使用 Crul 来测试您的 API。

```
curl https://api-id.execute-api.us-east-2.amazonaws.com
```

### 使用Amazon CLI 创建 HTTP API
<a name="http-api-examples.cli.quick-create"></a>

您可以使用“快速创建”功能，创建具有 Lambda 或 HTTP 集成、默认“捕获全部”路由和默认阶段（配置为自动部署更改）的 API。以下 [create-api](https://docs.amazonaws.cn/cli/latest/reference/apigatewayv2/create-api.html) 使用快速创建来创建与后端上的 Lambda 函数集成的 API。

**注意**  
要调用 Lambda 集成，API Gateway 必须具有所需的权限。您可以使用基于资源的策略或 IAM 角色，为 API Gateway 授予权限以调用 Lambda 函数。如需了解更多信息，请参阅 *Amazon Lambda 开发人员指南*中的 [Amazon Lambda 权限](https://docs.amazonaws.cn/lambda/latest/dg/lambda-permissions.html)。

**Example**  

```
aws apigatewayv2 create-api --name my-api --protocol-type HTTP --target arn:aws:lambda:us-east-2:123456789012:function:function-name
```

现在，您的 API 已准备好，可进行调用。您可以通过在浏览器中输入其调用 URL 或使用 Crul 来测试您的 API。

```
curl https://api-id.execute-api.us-east-2.amazonaws.com
```