기본 용어

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요.
정보

Apigee에서 의미가 고유한 공통 개념이 몇 가지 있습니다.

용어 정의
API

애플리케이션 프로그래밍 인터페이스는 한 애플리케이션이 다른 애플리케이션의 기능이나 데이터를 쉽게 사용할 수 있게 하는 인터페이스입니다.

API는 애플리케이션 로직과 데이터의 안정적이고 간편한 진입점을 정의하여 개발자가 다른 개발자가 빌드한 애플리케이션 로직에 쉽게 액세스하고 재사용할 수 있게 해줍니다. 웹 API의 경우 로직 및 데이터가 네트워크를 통해 노출됩니다. API를 사용하는 애플리케이션은 변경사항에 민감하므로 API도 계약을 암시합니다. 이 계약은 일정 기간 동안 API가 예측 가능한 방식으로 변경될 것이라는 확신을 줍니다.

Apigee는 API에 대한 풍부한 정보와 개발 및 사용에 대한 권장사항을 제공합니다. 시작하려면 API 디자인 웹캐스트를 참고하거나 무료 eBook 웹 API 설계: 개발자가 좋아하는 인터페이스 만들기를 위한 누락된 링크 권장사항을 다운로드하세요.

API 프록시

하나 이상의 API, 일반 HTTP 서비스 또는 애플리케이션 (예: Node.js)에 대한 Edge의 퍼사드입니다.

API 프록시는 Apigee Edge에서 제공하는 리소스 집합을 사용하는 구성 파일, 정책, 코드의 집합으로 구현됩니다. API 프록시는 Apigee Edge 관리 UI를 사용하여 생성 및 구성하거나 텍스트 편집기 또는 IDE에서 로컬로 구현할 수 있습니다.

API 프록시에서 제공되는 전면은 개발자용 API를 백엔드 서비스에서 분리하고, 코드 변경으로부터 개발자를 보호하며, 내부 개발팀에 영향을 미치지 않으면서 Edge에서 혁신이 가능하게 합니다. 개발팀에서 백엔드를 변경하면 개발자가 동일한 인터페이스를 중단 없이 계속 호출합니다. Apigee를 사용하면 여러 인터페이스를 동일한 API에 노출시킬 수 있으므로 다양한 개발자 틈새 요구사항을 동시에 충족할 수 있도록 API 서명을 맞춤설정할 수 있습니다.

API 기본 경로 및 리소스

네트워크 주소 및 URI로 정의된 API입니다. API는 기본 경로API 리소스 집합으로 구성됩니다. 모든 API 프록시는 기본 경로와 여러 API 리소스 경로(선택 사항)를 정의합니다. API는 단순히 공통의 기본 경로를 공유하는 URI의 집합이라고 생각하면 됩니다.

API를 보다 쉽게 관리할 수 있도록 Apigee는 이러한 원시 URI를 표시 이름 및 설명으로 보강합니다. Edge를 사용하면 URI에 정책과 코드를 연결하여 API 동작을 세밀하게 제어하고 관리할 수 있습니다.

API 제품

할당량 또는 서비스 요금제와 결합된 API 리소스 (URI) 모음으로, 설계 시점에 앱 개발자에게 게시됩니다. API 제품을 수익 창출을 위한 API 패키지로 묶을 수 있습니다.

API 키는 하나 이상의 API 제품에 결합되며, 앱과 앱에서 사용할 수 있는 URI 번들 간에 결합을 적용합니다.

API 패키지 개발자에게 번들로 제시되고 일반적으로 수익 창출에서 정의된 요금제와 연관된 API 제품 모음입니다.

애플리케이션의 약어입니다. 이라는 용어는 API를 사용하는 모바일 애플리케이션을 지칭합니다. 개발자는 다양한 프로그래밍 언어 및 다양한 기술과 플랫폼을 사용하여 앱을 구현합니다. API를 사용하려는 개발자는 Apigee Edge의 API 제공업체 조직에 앱을 등록합니다.

앱이 등록되면 Apigee는 앱을 식별하는 API 키와 보안 비밀을 생성합니다. 개발자는 요청 수행 시 키를 표시하는 API 키를 앱에 삽입합니다. API 서비스는 API 키 직접 검증 또는 OAuth를 통해 API 키를 중심으로 보안을 구현합니다.

환경

API 프록시의 런타임 실행 컨텍스트입니다. API 프록시는 노출되는 API가 네트워크를 통해 액세스할 수 있기 전에 환경에 배포해야 합니다. 기본적으로 조직은 testprod라는 두 가지 환경으로 프로비저닝됩니다.

  • test 환경은 일반적으로 개발 중에 API 프록시를 배포하는 데 사용됩니다.
  • prod 환경은 일반적으로 개발 및 테스트된 후 테스트 환경에서 API 프록시를 홍보하는 데 사용됩니다.
조직

API 프록시, API 제품, API 패키지, 앱, 개발자를 포함한 Apigee Edge 계정의 모든 객체를 위한 컨테이너입니다.

구성원으로 있는 각 조직에 사용자 계정이 필요합니다. (대부분의 사용자는 한 조직에서만 계정을 갖게 됩니다.)

정책

API 프록시 처리 흐름의 재사용 가능한 원자적 논리 단위로 실행되는 처리 단계입니다.

일반적인 정책 기반 기능에는 메시지 형식 변환, 액세스 제어 적용, 추가 정보를 위한한 원격 서비스 호출, 외부 사용자의 민감한 정보 차단, 잠재적인 위협에 대한 메시지 콘텐츠 검사, 성능 향상을 위한 일반적인 응답 캐싱 등이 포함됩니다.

정책은 요청 또는 응답 메시지의 내용이나 컨텍스트에 따라 조건부로 실행될 수 있습니다. 예를 들어 스마트폰에서 요청 메시지를 보낸 경우 변환 정책을 실행하여 응답 형식을 맞춤설정할 수 있습니다.

API 리소스 경로 RESTful 개념, 리소스 경로는 주어진 리소스의 네트워크 경로를 식별하는 동일한 리소스 식별자(URI)입니다.
버전

개발자용 API 인터페이스 버전입니다.

예를 들면 pivotaltracker.com/services/v3 또는 api.enterprise.apigee.com/v1입니다.

이 용어는 API 프록시에 번들로 포함되는 구성 및 정책의 숫자가 매겨진 버전 제어 패키지인 수정 버전과 구별됩니다. API 인터페이스에는 버전이 있습니다. API 프록시에는 수정 버전이 있습니다.

수정 버전 구성 및 정책의 숫자가 매겨진 버전 제어 패키지이며, API 프록시에 번들로 포함됩니다. 이 용어는 개발자용 API 인터페이스인 버전과 구분됩니다. 위의 버전을 참조하세요.