용어

이 페이지에서는 API 게이트웨이 문서에 사용되는 용어에 대한 간략한 정의와 이러한 용어에 관한 자세한 정보를 확인할 수 있는 링크를 제공합니다.

API
한 애플리케이션에서 다른 애플리케이션의 기능 또는 데이터를 쉽게 사용할 수 있게 해주는 REST 인터페이스입니다. 안정적이고 간단하며 문서화가 잘 되어 있는 진입점을 정의하여, API를 사용하면 개발자가 다른 개발자가 빌드한 애플리케이션 로직에 쉽게 액세스하고 재사용할 수 있습니다.
API 구성
API 정의를 API 게이트웨이에 업로드할 때 생성됩니다. API 정의를 업로드할 때마다 API 게이트웨이가 새 API 구성을 만듭니다. 즉, API 구성을 만들 수 있지만 이를 나중에 수정할 수는 없습니다. 나중에 API 정의를 수정하고 이를 업로드하면 API 구성이 새로 생성됩니다.
API 정의
API 구성을 만들기 위해 사용되는 Open API 2.0 사양 또는 gRPC 구성입니다. API 정의는 백엔드 서비스의 URL, 요청에 전달되는 데이터의 데이터 형식, 서비스에서 반환되는 데이터의 데이터 형식, 서비스 액세스 제어를 위해 사용되는 인증 메커니즘, 기타 다양한 옵션을 지정합니다.
API 키
클라이언트 애플리케이션에서 API를 호출할 때 전달하는 코드입니다. API 키는 API를 호출하는 애플리케이션 또는 Google Cloud 프로젝트를 식별합니다. API 게이트웨이 API에서 API 키를 사용하는 방법에 대한 자세한 내용은 API 키를 사용하는 경우 및 조건을 참조하세요.
Auth0
사용자가 애플리케이션에 인증하는 방법을 정의할 수 있는 서비스입니다. 자세한 내용은 Auth0를 참조하세요.
CORS
원본 간 리소스 공유(CORS)는 웹 애플리케이션이 다른 도메인(엄밀히 말하면 다른 원본)의 서버에 있는 리소스에 액세스할 수 있도록 하는 사양입니다. CORS에 대해 자세히 알아보려면 Mozilla Developer Network (MDN) 웹 문서Fetch Living 표준을 참고하세요.
Firebase 인증
Google, Facebook 또는 Twitter와 같은 인기 있는 ID 공급업체의 사용자 인증 정보를 사용하여 클라이언트 애플리케이션에 최종 사용자 로그인을 할 수 있도록 지원하는 Google의 인증 서비스입니다. 자세한 내용은 Firebase 인증을 참조하세요.
게이트웨이
배포된 API 구성을 호스팅하는 Envoy 기반의 고성능 확장 가능한 프록시입니다. 게이트웨이를 만들면 API 클라이언트가 API에 액세스하기 위해 사용되는 외부 연결용 URL이 생성됩니다. 게이트웨이는 단일 API 구성만 호스팅합니다. 동일한 게이트웨이에 API 구성을 여러 개 배포할 수 없습니다.
Google ID 토큰
Google 사용자 계정 또는 서비스 계정을 식별하는 데 필요한 OpenID Connect 필드가 포함되어 있고 Google의 인증 서비스인 https://accounts.google.com으로 서명된 JSON 웹 토큰 (JWT)입니다.
gRPC
Google이 개발한 고성능 오픈소스 범용 RPC 프레임워크입니다. gRPC에서 클라이언트 애플리케이션은 다른 머신의 서버 애플리케이션에 있는 메서드를 로컬 객체처럼 직접 호출할 수 있습니다. API 게이트웨이와 함께 gRPC를 사용하는 방법은 gRPC 개요를 참조하고 일반적인 내용은 gRPC 웹사이트를 참조하세요.
JWT
JSON 웹 토큰은 HTTP Authorization 헤더와 URI 쿼리 매개변수에 사용하는 개방형 일반 액세스 토큰 형식입니다. 일반적인 내용은 JSON 웹 토큰 소개를 참고하세요.
OpenAPI
Open API Initiative는 REST API 설명을 표준화하기 위한 업계 차원의 노력을 의미합니다. OpenAPI 사양(이전의 Swagger 사양)에 맞게 설명된 API는 문서를 만들고, 테스트를 자동화하고, 클라이언트 및 서버용 코드를 생성하는 일반 도구로 지원될 수 있습니다. 자세한 내용은 OpenAPI 개요를 참조하세요.
OpenAPI 문서
API를 설명하는 데 사용되는 YAML 또는 JSON 형식의 파일입니다. 이 파일을 API 정의라고도 부릅니다. API 게이트웨이에 업로드하면 OpenAPI 문서가 API 구성으로 변환됩니다.
노출 영역
API의 공개 인터페이스입니다. API의 노출 영역은 메서드는 물론 메서드에 사용되는 매개변수 및 반환 유형으로 구성됩니다.