

# API Gateway에서 HTTP API 개발
<a name="http-api-develop"></a>

이 단원에서는 API Gateway API를 개발하는 동안 필요한 API Gateway 기능에 대해 자세히 설명합니다.

API Gateway API를 개발할 때 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 Management Console](#apigateway-http-api-create.console)
+ [AWS CLI를 사용하여 HTTP API 생성](#http-api-examples.cli.quick-create)

### 를 사용하여 HTTP API 생성AWS Management Console
<a name="apigateway-http-api-create.console"></a>

1. [API Gateway 콘솔](https://console.aws.amazon.com/apigateway)을 엽니다.

1. **API 생성(Create API)**을 선택합니다.

1. **HTTP API**에서 **빌드**를 선택합니다.

1. **통합 추가**를 선택한 다음, AWS Lambda 함수를 선택하거나 HTTP 엔드포인트를 입력합니다.

1. **이름**에 API의 이름을 입력합니다.

1. [**Review and create**]를 선택합니다.

1. **Create**를 선택합니다.

이제 API를 호출할 준비가 되었습니다. 브라우저에서 호출 URL을 입력하거나 Curl을 사용하여 API를 테스트할 수 있습니다.

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

### AWS CLI를 사용하여 HTTP API 생성
<a name="http-api-examples.cli.quick-create"></a>

빠른 생성을 사용하여 Lambda 또는 HTTP 통합, 기본 catch-all 경로, 변경 사항을 자동으로 배포하도록 구성된 기본 스테이지를 통해 API를 생성할 수 있습니다. 다음 [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) 명령은 빠른 생성을 사용하여 백엔드에서 Lambda 함수와 통합되는 API를 생성합니다.

**참고**  
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
```