Amazon API Gateway에서 REST API 호출
배포된 API를 호출하기 위해 클라이언트는 API 실행을 위한 API Gateway 구성 요소 서비스(예: execute-api)에 대한 URL 요청을 제출합니다.
기본 REST API URL의 형식은 다음과 같습니다.
https://restapi_id.execute-api.region.amazonaws.com/stage_name/
여기서 restapi_id는 API 식별자이고, region은 AWS 리전이고, stage_name은 API 배포의 스테이지 이름입니다.
중요
API를 호출하기 전에 API Gateway에서 배포해야 합니다. API 배포에 대한 지침은 Amazon API Gateway에서 REST API 배포을 참조하세요.
주제
API의 간접 호출 URL 얻기
콘솔, AWS CLI 또는 내보낸 OpenAPI 정의를 사용하여 API의 간접 호출 URL을 가져올 수 있습니다.
콘솔을 사용하여 API의 간접 호출 URL 얻기
다음 절차에서는 REST API 콘솔에서 API의 간접 호출 URL을 얻는 방법을 보여 줍니다.
REST API 콘솔을 사용하여 API의 간접 호출 URL을 얻으려는 경우
https://console.aws.amazon.com/apigateway
에서 API Gateway 콘솔에 로그인합니다. 배포된 API를 선택합니다.
-
기본 탐색 창에서 스테이지를 선택합니다.
-
스테이지 세부 정보에서 복사 아이콘을 선택하여 API의 호출 URL을 복사합니다.
이 URL은 API의 루트 리소스용입니다.
API의 다른 리소스에 대한 API의 간접 호출 URL을 얻으려면 보조 탐색 창 아래에서 단계를 확장한 다음 메서드를 선택합니다.
복사 아이콘을 선택해 API의 리소스 수준 간접 호출 URL을 복사합니다.
AWS CLI를 사용하여 API의 간접 호출 URL 얻기
다음 절차에서는 AWS CLI를 사용하여 API의 간접 호출 URL을 얻는 방법을 보여 줍니다.
AWS CLI를 사용하여 콘솔에서 API의 간접 호출 URL 얻으려는 경우
rest-api-id를 편집하려면 다음 명령을 입력합니다. 이 명령은 해당 지역의 모든rest-api-id값을 반환합니다. 자세한 내용은 get-rest-apis을 참조하세요aws apigateway get-rest-apis예제
rest-api-id를rest-api-id로 바꾸고, 예제{stage-name}을{stage-name}로 바꾸고,{region}을 해당 리전으로 바꿉니다.https://{restapi_id}.execute-api.{region}.amazonaws.com/{stage_name}/
내보낸 API의 OpenAPI 정의 파일을 사용하여 API의 간접 호출 URL 가져오기
API의 내보낸 OpenAPI 정의 파일에서 host 필드와 basePath 필드를 결합하여 이 루트 URL을 구성할 수도 있습니다. API 내보내기 방법에 대한 지침은 API Gateway에서 REST API 내보내기 섹션을 참조하세요.
API 간접 호출
브라우저, curl 또는 Postman
또한 API Gateway 콘솔을 사용하여 API 호출을 테스트할 수 있습니다. 테스트에서는 API Gateway의 TestInvoke 기능을 사용하므로 API를 배포하기 전에 API를 테스트할 수 있습니다. 자세한 내용은 API Gateway 콘솔을 사용하여 REST API 메서드 테스트 단원을 참조하십시오.
참고
호출 URL의 쿼리 문자열 파라미터 값은 %%를 포함할 수 없습니다.
웹 브라우저를 사용하여 API 간접 호출
API에서 익명 액세스를 허용하는 경우 웹 브라우저를 사용하여 GET 메서드를 간접 호출할 수 있습니다. 브라우저의 주소 표시줄에 전체 간접 호출 URL을 입력합니다.
다른 방법이나 인증이 필요한 직접 호출의 경우 페이로드를 지정하거나 요청에 서명해야 합니다. AWS SDK 중 하나를 사용하여 HTML 페이지 뒤의 스크립트나 클라이언트 애플리케이션에서 이러한 호출을 처리할 수 있습니다.
curl을 사용하여 API 간접 호출
터미널에서 curl과prod 스테이지의 getUsers 리소스에서 GET 메서드를 간접 호출합니다.
