BLOG

API 설계자 및 개발자를 위한 주요 리소스
작성일: 2019-11-01

API 아키텍처 및 개발에 대한 블로그 연재글에 대해 많은 분들이 관심을 가져주시고 있는데요. 오늘은 Amazon API Gateway를 통해 REST APIs와 AWS AppSync를 사용한 GraphQL API의 모범 사례에 대해 다루어 볼 예정입니다. 또한 모든 API 개발자가 알아야 할 최고의 리소스에 대해서도 소개해 드리겠습니다.

 

테크 이야기, 웨비나 및 Twitch 라이브 스트림

AWS의 기술 직원들은 새로운 서비스를 시작하여 모범 사례 및 고객 질문을 다루는 다양한 디지털 미디어를 제작했습니다. API 구축에 대한 팁과 요령은 다음 영상을 통해 확인해 주세요!

  • Happy Little APIs: 이것은 훌륭한 개발자인 Eric Johnson이 제작한 멀티 파트 시리즈입니다. 그는 실제 API를 구축하는 방법을 보여주는 강연들을 진행하고 있습니다.
  • API Gateway의 WebSocket 웨비나: 이제 API Gateway는 Websocket과 함께 실시간 API를 지원합니다. 이 웨비나에서는 해당 기능을 사용하는 방법과 API Gateway가 실시간 API를 관리하도록 해야 하는 이유에 대해 설명합니다.
  • 엔터프라이즈 급의 API 구축을 위한 모범 사례: API Gateway는 REST 개발의 구축 및 배포하는 데 걸리는 시간을 단축하면서, 개발, 보안 및 관리를 보다 쉽게 할 수 있습니다.
  • AWS AppSync 및 GraphQL 소개: AppSync를 사용하면 실시간 및 오프라인 기능으로 고도의 데이터 애플리케이션을 구축 할 수 있습니다.

 

실습 워크샵 및 예제를 통한 경험 쌓기

Serverless REST API 개발을 시작하는 가장 쉬운 방법 중 하나는 SAM (Serverless Application Model )을 사용하는 것 입니다. SAM을 사용하면 API 및 Lambda 기능을 시스템에서 로컬로 실행하여 쉽게 개발하고 테스트할 수 있습니다.

 

예를 들어, 몇 줄의 코드만으로 API 게이트웨이를 Lambda의 이벤트 소스로 구성할 수 있습니다.

 

Type: Api

Properties:

Path: /photos

Method: post

 

GitHub 페이지에는 API Gateway에 대한 승인(IAM, Cognito), 요청, 응답, 다양한 정책 및 CORS 구성을 시작하는 데 도움이 되는 많은 훌륭한 예가 있습니다.

GraphQL로 작업하는 경우 Amplify Framework를 확인해야 합니다. 이는 REST 또는 GraphQL을 사용하여 AuthN 및 백엔드 API가 내장된 웹 애플리케이션을 빠르게 구축하는 공식 AWS 프로젝트입니다. 몇 줄의 코드만으로 Amplify가 GraphQL API에 필요한 모든 구성을 추가하도록 할 수 있습니다. 애플리케이션을 AppSync API와 통합하는 두 가지 옵션이 있습니다.

  1. Amplify GraphQL Client를 직접 사용
  2. AWS AppSync SDK를 사용

 

AppSync GraphQL API를 탑재한 ReactJS를 사용하여 단일 페이지 웹 애플리케이션을 작성하는 방법을 보여주는 예제를 포함 하여 Amplify 툴 킷에 대한 훌륭한 설명이 제공됩니다.

 

마지막으로, 실습 경험에 관심이 있다면 다음을 살펴봐 주십시오.

 

  • Amazon API Gateway WildRydes 워크샵. 이 워크샵 에서는 API 게이트웨이를 탑재한 REST 백엔드를 사용하여 기능적인 단일 페이지 웹 앱을 구축하는 방법에 대해 설명합니다.
  • AWS AppSync GraphQL 사진 워크샵. 이 워크샵 에서는 Amplify를 사용하여 AppSync로 구동되는 사진 공유 웹 앱을 신속하게 구축하는 방법에 대해 설명합니다.

 

유용한 문서

AWS의 공식 문서는 설계자와 개발자에게 실무적으로 유용한 소스입니다. API 게이트웨이 개발자 가이드를 시작해 보세요. API Gateway에는 현재 서비스 관리를 위한 두 개의 API (V1 및 V2)가 있고, 여기에서 SDK 및 CLI 참조를 볼 수 있습니다.

 

AppSync 개발자 가이드를 시작하여 AppSync 관리 API를 확인하십시오.

 

요약

API 설계자로서 귀하의 업무는 사용 예에 가장 적합한 API를 설계하고 구현할 뿐만 아니라 제품의 비용적으로 가장 효율적인 API 유형을 파악하는 것입니다. 예를 들어, 요청량이 많은 애플리케이션 (“chatty”)은 REST 대신 GraphQL 구현의 이점을 얻을 수 있습니다.

 

API Gateway는 현재 백만 요청 건 당 $3.50을 청구하고 매월 백만 건의 무료 계층을 제공하고 있습니다. 또한 요청량이 증가 함에 따라 비용을 절감할 수 있는 단계적인 가격 설정 옵션이 있습니다. AppSync는 현재 Query and Mutation 요청에 대해 백만 건 당 $ 4.00을 청구하고 있습니다.

 

요청에 따른 AppSync 가격이 약간 더 높은 반면, GraphQL의 특성으로 인해 일반적으로 전체 요청 수가 훨씬 감소한다는 점을 유의해 주십시오.

 

원문 URL: https://aws.amazon.com/ko/blogs/architecture/top-resources-for-api-architects-and-developers/

 

** 메가존 클라우드 TechBlog는 AWS BLOG 영문 게재 글 중에서 한국 사용자들에게 유용한 정보 및 콘텐츠를 우선적으로 번역하여 내부 엔지니어 검수를 받아서, 정기적으로 게재하고 있습니다. 추가로 번역 및 게재를 희망하는 글에 대해서 관리자에게 메일 또는 SNS 페이지에 댓글을 남겨주시면, 우선적으로 번역해서 전달해드리도록 하겠습니다.