---
title: "API Gateway 개요"
slug: "ai-application-service-apigateway"
updated: 2026-10-22T10:46:41Z
published: 2026-10-22T10:46:41Z
canonical: "api-gov.ncloud-docs.com/ai-application-service-apigateway"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Gateway 개요

API Gateway를 통해 API 호출과 관련된 모든 작업들을 편리하게 진행할 수 있습니다. API를 안정적으로 실행하기 위한 다양한 관리 기능들과 API 사용 현황을 실시간으로 확인할 수 있는 대시보드를 제공합니다. 이를 통해 고객은 보다 효율적으로 비즈니스에 집중할 수 있습니다.

## 기본 정보

### API URL

```
https://apigateway.apigw.gov-ntruss.com
```

#### [Swagger UI 바로가기](https://apigateway.apigw.gov-ntruss.com/apigw/swagger-ui?productId=x23oik7hdq&apiId=spqnhzaqr1&stageId=k5g0runfax&stageType=default)

### 요청 헤더

API Gateway API에서 공통으로 사용하는 헤더는 다음과 같습니다.

| 항목 | Required | 설명 |
| --- | --- | --- |
| Content-Type | Required | 요청 Body Content Type을 application/json으로 지정 (POST) |
| x-ncp-apigw-timestamp | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것이다. API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 |
| x-ncp-iam-access-key | Required | 포탈 또는 Sub Account에서 발급받은 Access Key ID |
| x-ncp-apigw-signature-v2 | Required | Body를 Access Key Id와 맵핑되는 SecretKey로 암호화한 서명 HMAC 암호화 알고리즘은 HmacSHA256 사용 |

### 응답 상태 코드

API Gateway API에서 공통으로 사용하는 응답 상태 코드는 다음과 같습니다.

#### 성공

요청이 성공한 경우, 반환되는 코드는 다음과 같습니다.

| HTTP 상태 코드 | 메시지 | 설명 |
| --- | --- | --- |
| 200 | OK | 요청 성공 |
| 201 | Created | 요청의 결과로 새로운 리소스가 생성됨 |
| 202 | Accepted | 요청이 수락되었지만 아직 완료되지 않았음 |
| 204 | No Content | 요청은 성공했지만 응답 콘텐츠 없음 |

#### 실패

요청이 실패한 경우, 반환되는 코드는 다음과 같습니다.

| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
| --- | --- | --- | --- |
| 400 | 100 | Bad Request Exception | HTTPS 프로토콜이나 UTF-8 인코딩으로 인한 요청 오류 |
| 401 | 200 | Authentication Failed | 요청한 리소스를 사용하기 위한 인증 정보가 제공되지 않았거나 유효하지 않음 |
| 401 | 210 | Permission Denied | 요청한 리소스에 대한 권한이 없음 |
| 403 | 230 | Forbidden | 요청한 리소스에 대한 권한이 없음 |
| 404 | 300 | Not Found Exception | 요청한 리소스를 찾을 수 없음 |
| 429 | 400 | Quota Exceeded | API 사용 한도(Quota)을 초과 |
| 429 | 410 | Throttle Limited | API 요청 속도를 초과 |
| 429 | 420 | Rate Limited | API 요청 속도를 초과 |
| 413 | 430 | Request Entity Too Large | 요청 바디 크기가 서버가 처리할 수 있는 한계를 초과 |
| 415 | 440 | Unsupported Media Type | 지원되지 않는 미디어 유형 |
| 503 | 500 | Endpoint Error | 엔드포인트 연결 에러 |
| 504 | 510 | Endpoint Timeout | 엔드포인트 연결 시간 초과 |
| 503 | 520 | Unknown Endpoint Domain | 엔드포인트가 인식되지 않거나 설정되지 않았음 |
| 503 | 530 | Connection Closed By Endpoint | 엔드포인트에서 연결 종료 |
| 500 | 900 | Unexpected Error | 예기치 않은 상황으로 요청 처리 실패 |

### HTTP/TLS 지원 버전

API Gateway API에서 지원하는 HTTP/TLS 버전은 다음과 같습니다.

| 프로토콜 | 지원 버전 |
| --- | --- |
| HTTP | - HTTP/1.1 - HTTP/2 |
| TLS | - TLSv1.2 - TLSv1.3 |

#### [NAVER Cloud Platform 인증키 및 Signature 생성 가이드 바로가기](/docs/common-ncpapi-ncpapi)

## 웹 콘솔

- [웹 콘솔 바로가기](https://console.gov-ncloud.com/apigw/myProducts)
- [웹 콘솔 가이드 바로가기](https://guide-gov.ncloud-docs.com/docs/api-gateway-overview)