本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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)
+ [在 API Gateway 中使用 HTTP API 的 OpenAPI 定義](http-api-open-api.md)

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

若要建立可操作的 API，您必須至少有一個路由、整合、階段和部署。

下列範例示範如何建立具有 AWS Lambda 或 HTTP 整合的 API、路由，以及設定為自動部署變更的預設階段。

本指南假設您已經熟悉 API Gateway 和 Lambda。如需更詳細的清單，請參閱[API Gateway 入門](getting-started.md)。

**Topics**
+ [使用 建立 HTTP API AWS 管理主控台](#apigateway-http-api-create.console)
+ [使用 CLI AWS 建立 HTTP API](#http-api-examples.cli.quick-create)

### 使用 建立 HTTP API AWS 管理主控台
<a name="apigateway-http-api-create.console"></a>

1. 開啟 [API Gateway 主控台](https://console.aws.amazon.com/apigateway)。

1. 選擇 **Create API** (建立 API)。

1. 在 **HTTP API** 下，選擇 **Build** (組建)。

1. 選擇 **Add integration** (新增整合)，然後選擇 AWS Lambda 函數或輸入 HTTP 端點。

1. 在 **Name** (名稱) 中，輸入 API 的名稱。

1. 選擇 **Review and create** (檢閱和建立)。

1. 選擇 **Create** (建立)。

現在您的 API 已準備好叫用。您可以透過在瀏覽器中輸入其調用 URL 或使用 Curl 來測試您的 API。

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

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

您可以使用快速建立來建立具有 Lambda 或 HTTP 整合的 API、預設的全部捕獲路由，以及設定為自動部署變更的預設階段。以下 [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) 命令會使用快速建立來建立 API，以便與後端的 Lambda 函式整合。

**注意**  
若要叫用 Lambda 整合，API Gateway 必須具有必要的許可。您可以使用以資源為基礎的政策或 IAM 角色來授與 API Gateway 叫用 Lambda 函數的許可。若要進一步了解，請參閱《 * AWS Lambda 開發人員指南*》中的[AWS Lambda 許可](https://docs.aws.amazon.com/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 或使用 Curl 來測試您的 API。

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