# API Gateway의 REST API 문서
<a name="api-gateway-documenting-api"></a>

 고객이 API를 이해하고 사용할 수 있도록 API를 문서화해야 합니다. API를 문서화하는 데 도움이 되도록 API Gateway에서는 개별 API 엔터티에 대한 도움말 콘텐츠를 API 개발 프로세스의 핵심 부분으로 추가하고 업데이트할 수 있습니다. API Gateway에서는 소스 콘텐츠가 저장되며 다양한 버전의 설명서를 보관할 수 있습니다. 설명서 버전을 API 단계와 연결하고, 단계별 설명서 스냅샷을 외부 OpenAPI 파일로 내보내고, 이 파일을 설명서 간행물로 배포할 수 있습니다.

API를 문서화하려면 [API Gateway REST API](https://docs.aws.amazon.com/apigateway/latest/api/)를 호출하거나, API Gateway용 [AWS SDK](https://aws.amazon.com/developer/tools/) 중 하나를 사용하거나, API Gateway용 [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/apigateway/)를 사용하거나, API Gateway 콘솔을 사용할 수 있습니다. 또한 외부 OpenAPI 파일에 정의된 설명서 부분을 가져오거나 내보낼 수 있습니다.

개발자 포털을 사용하면 API 설명서를 개발자와 공유할 수 있습니다. 예제를 보려면 AWS 파트너 네트워크(APN) 블로그에서 [ReadMe를 API Gateway와 통합하여 개발자 허브를 최신 상태로 유지](https://aws.amazon.com/blogs/apn/integrating-readme-with-amazon-api-gateway-to-keep-your-developer-hub-up-to-date/) 또는 [SmartBear의 SwaggerHub를 사용하여 Amazon API Gateway에서 API 개발을 간소화하는 방법](https://aws.amazon.com/blogs/apn/how-to-streamline-api-development-on-amazon-api-gateway-using-smartbear-swaggerhub/)을 참조하세요.

**Topics**
+ [API Gateway에 API 설명서 표시](api-gateway-documenting-api-content-representation.md)
+ [API Gateway 콘솔을 사용하여 API 문서화](api-gateway-documenting-api-quick-start-with-console.md)
+ [API Gateway 콘솔을 사용하여 API 설명서 게시](apigateway-documenting-api-with-console.md)
+ [API Gateway REST API를 사용하여 API 문서화](api-gateway-documenting-api-quick-start-with-restapi.md)
+ [API Gateway REST API를 사용하여 API 설명서 게시](api-gateway-documenting-api-quick-start-publishing.md)
+ [API 설명서 가져오기](api-gateway-documenting-api-quick-start-import-export.md)
+ [API Gateway에서 API 설명서에 대한 액세스 제어](api-gateway-documenting-api-content-provision-and-consumption.md)