Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
Apigee에서 의미가 고유한 공통 개념이 몇 가지 있습니다.
| 용어 | 정의 |
|---|---|
| API | 기존 API의 퍼사드 역할을 하는 작동하는 프록시입니다. 개발자는 기존 API를 호출하는 대신 Apigee에서 생성한 새 API를 호출하기 시작합니다. 이 퍼사드는 백엔드 API와 공개 인터페이스를 분리하여 개발자가 백엔드 변경을 방지하면서 내부 개발팀에 영향을 주지 않고 에지에서 혁신을 달성할 수 있도록 합니다. 개발자가 백엔드를 변경하면 개발자는 동일한 API를 중단 없이 계속 호출합니다. 고급 시나리오에서는 Apigee를 사용하면 동일한 API에 여러 인터페이스를 노출할 수 있으므로 다양한 개발자의 역할 요구 사항을 동시에 충족할 수 있도록 API 서명을 맞춤설정할 수 있습니다. |
| API 기본 경로 및 리소스 | API는 기본 경로와 리소스 집합(리소스 경로라고도 함)으로 구성됩니다. 각 API에 대해 단일 루트 URL과 여러 리소스 경로를 정의합니다. API는 단순히 공통 기본 경로를 공유하는 URI의 집합이라고 생각하면 됩니다. API를 보다 쉽게 관리할 수 있도록 Apigee에서는 이러한 원시 URI를 표시 이름 및 설명으로 보강합니다. |
| API 사용자 | API 제공업체가 만든 API를 사용하는 '앱 개발자'와 동의어입니다. |
| API 개발자 | API 제공업체 조직에서 API를 빌드하는 소프트웨어 엔지니어입니다. 이러한 API는 앱 개발자(API 사용자)가 앱을 빌드하는 데 사용됩니다. |
| API 패키지 | 개발자에게 번들로 제시되고 일반적으로 요금제와 연관된 API 제품의 모음입니다. |
| API 제품 | 서비스 요금제와 결합되고 개발자에게 번들로 제공되는 API 리소스(URI) 모음입니다. API 제품은 모니터링 또는 분석을 위해 비즈니스와 관련된 일부 메타데이터도 포함할 수 있습니다. 하나 이상의 리소스를 API 제품에 포함해 수익을 창출할 수 있으며, 이 API 제품을 수익 창출을 위한 API 패키지에 번들로 포함할 수 있습니다. |
| API 공급업체 | API 제공업체는 API 사용자(앱 개발자)가 사용할 API를 Edge를 사용하여 빌드합니다. |
| 앱 개발자 | Edge에서 앱 개발자는 API 제공업체로 앱을 등록합니다. 이 방법으로 앱 개발자는 제공업체의 API 프록시를 호출하는 데 필요한 API 키를 가져옵니다. |
| 앱 | 개발자는 앱을 사용하여 API 제품의 리소스에 액세스합니다. 앱을 만들 때 포함할 API 제품을 선택하면 Apigee에서 키를 생성합니다. 각 앱에는 여러 API 제품에 대한 액세스를 제공하는 단일 키가 있습니다. 앱에서는 리소스에 액세스할 수 있는 사용자를 제어할 수 있습니다. 앱의 키를 취소하고 새로고침하여 API 제품에 액세스할 수 있는 사용자를 제어할 수 있습니다. 또한 앱의 제품 액세스 권한을 취소하거나 삭제하여 리소스 번들에 대한 액세스를 제어할 수 있습니다. |
| 잔액 세부정보 | 선불 개발자의 경우 개발자 계정의 잔액입니다. |
| 마감된 조정 | 게시된 결제 문서에 적용된 조정입니다. |
| 마감된 결제 월 | 결제 문서가 게시된 전체 캘린더 월입니다. |
| 커스텀 한도 | 수익 창출을 사용하여 명시적으로 설정할 수 있는 한도(예: API 제품의 트랜잭션 수 제한)이며, 명시적 한도라고도 합니다. |
| 개발자 카테고리 요금제 | 특정 카테고리의 모든 개발자에게 적용되며 해당 카테고리의 모든 개발자가 구매할 수 있는 요금제입니다. |
| 개발자 요금제 | 특정 개발자에게 적용되며 해당 개발자만 구매할 수 있는 요금제입니다. |
| 공개 대리인 | 상법에 따라 제3자와의 법적 관계를 만들기 위해 주 구성원이라고 하는 다른 사람을 대신할 권한이 있는 사람입니다. 수익 창출에서 API 제공업체가 개발자를 대신해 수익(및 판매세)을 모으는 개발자의 공개 대리인 역할을 하는 것과 같은 공유 수익 계획에 대한 세금 모델을 설정할 수 있습니다. |
| 공개 세금 모델 | API 제공업체가 개발자의 공개 대리인 역할을 하는 세금 모델입니다. |
| 환경 | API의 런타임 실행 컨텍스트입니다. 런타임 시 API에 액세스하려면 먼저 환경에 API를 배포해야 합니다. 기본적으로 Apigee 조직은 'test' 및 'prod'라는 두 가지 환경으로 프로비저닝됩니다. 'test' 환경은 일반적으로 테스트 중인 API를 배포하는 데 사용됩니다. 'prod' 환경은 일반적으로 프로덕션용 API를 배포하는 데 사용됩니다. |
| 하이브리드 세금 모델 | API 제공업체가 개발자의 공개 대리인 역할을 하는 세금 모델입니다. 그러나 API 제공업체는 개발자를 대신하여 구독자에게서 징수한 판매세를 현지 세무 당국에 지불합니다. |
| 암시적 한도 | 수익 창출에서 설정한 한도(예: 개발자 선불 잔액 한도)입니다. |
| 수익 창출 | 사용하기 쉽고 유연한 API 제품 수익 창출 방법을 제공하는 Apigee Edge 개발자 서비스의 구성요소입니다. |
| 사용된 월별 납부액 | 설정 수수료 + 트랜잭션 수수료 + 반복 수수료가 포함된 개발자의 특정 월 총 사용량입니다. |
| 월별 결제 | 구매한 요금제에 따라 개발자가 수행하는 반복 결제입니다. 요금제에는 사용량에 관계없이 개발자에게 매달 청구되는 반복 요금이 발생할 수 있습니다. |
| 순 잔액 명세서 | 인보이스와 수익 배분 명세서의 순 잔액을 보여주는 금융 문서입니다. |
| 미해결 조정 | 게시된 결제 문서에 아직 적용되지 않은 조정입니다. |
| 미해결된 청구 월 | '최종' 결제 문서가 게시되지 않은 전체 캘린더 월입니다. |
| 조직 | API, API 제품, API 패키지, 앱, 개발자와 같은 Apigee 계정의 모든 객체에 대한 컨테이너입니다. 구성원으로 속할 수 있는 각 조직에는 사용자 계정이 필요합니다. (대부분의 사용자는 한 조직에서만 계정을 갖게 됩니다.) 제출하는 각 API 요청에 사용자 인증 정보(사용자 이름 및 비밀번호) 및 조직의 이름을 제공해야 합니다. |
| 패키지 카탈로그 | API 패키지 목록입니다. 각 패키지는 API 제품 및 요금제와 함께 나열됩니다. |
| 선불 잔액 | 선불 개발자가 API 패키지 요금을 미리 지불할 수 있는 금액입니다. |
| 선불 개발자 | API 제품 사용 비용을 미리 지불하는 개발자입니다. API 제품이 사용되면 선불 개발자의 잔액에서 금액이 차감됩니다. 개발자는 API 제품을 구매할 수 있는 충분한 선불 잔액을 유지해야 합니다. API 제공업체가 개발자에게 선불 또는 후불 상태를 할당합니다. |
| 정책 | API 흐름 내에서 재사용 가능한 원자적 논리 단위로 실행되는 처리 단계입니다. 일반적인 정책에는 적절한 엔드포인트로 요청 라우팅, 메시지 형식 변환, 액세스 제어 적용, 추가 정보를 위한 원격 서비스 호출, 외부 사용자의 민감한 정보 차단, 잠재적인 위협에 대한 메시지 콘텐츠 검사, 성능 향상을 위한 일반적인 응답 캐싱 등이 포함됩니다. 정책은 요청 또는 응답 메시지의 내용이나 컨텍스트에 따라 조건부로 실행될 수 있습니다. 예를 들어 스마트폰에서 요청 메시지가 전송된 경우 변환 정책을 실행하여 응답 형식을 맞춤설정할 수 있습니다. |
| 후불 개발자 | 인보이스를 통해 API 제품 사용 요금을 월 단위로 결제하는 개발자입니다. 개발자는 인보이스에 포함된 요금제에서 설정한 결제 약관에 따라 API 제품 사용 요금을 지불합니다. 개발자에게 API 제공업체가 후불 또는 선불 상태를 할당합니다. |
| 가격대 | 판매될 수 있는 다양한 가격 범위입니다. |
| 요율표 요금제 | 수익 창출 API 제품과 관련된 각 트랜잭션에 대해 개발자에게 고정 요율 또는 변동 요율로 청구하는 요금제입니다. |
| 요금제 | 수익 창출 API 패키지에서 제공하는 API 제품 사용에 관한 수수료, 기타 요금, 수익 배분의 사양입니다. |
| 리소스 경로 |
RESTful 개념, 리소스 경로는 지정된 리소스에 대한 네트워크 경로를 식별하는 URI(식별된 균일한 리소스)입니다. |
| 수익 배분 요금제 | 수익 창출 API 제품과 관련된 각 트랜잭션에서 생성된 수익의 비율을 요청을 실행하는 앱 개발자와 공유하는 요금제입니다. |
| 수익 배분 및 요율 요금제 | 수익 창출 API 제품과 관련된 각 트랜잭션에서 생성된 수익의 비율을 요청을 실행하는 앱 개발자와 공유하는 요금제입니다. 또한 개발자에게 각 트랜잭션의 고정 수수료 또는 변동 수수료도 청구합니다. |
| 결제 인보이스 | 수익 배분 명세서 대신 생성되는 금융 문서입니다. 이 문서에는 개발자에게 지급해야 할 금액이 상세하게 나와 있고 개발자를 대신하여 API 제공업체에 대한 인보이스 역할을 합니다. |
| 표준 요금제 | 모든 개발자가 구매할 수 있는 요금제입니다. |
| tax | 개발자의 사용량 및 수수료에 적용되는 총 세금입니다. |
| 잔액 충전 | 선불 개발자가 선불 잔액을 충전하는 작업입니다. |
| 트랜잭션 기록 정책 | 수익 창출 방법으로 트랜잭션 매개변수와 커스텀 속성을 캡처할 수 있게 해주는 메커니즘입니다. 수익 창출 처리를 수행하려면 이 정보가 필요합니다. 예를 들어 각 트랜잭션에서 캡처된 커스텀 속성을 기반으로 API 요청 및 응답에 요금제를 적용합니다. |
| 비공개 대리인 | 개발자를 대신하여(세금 목적으로만) 콘텐츠를 구매하는 것으로 간주되는 등, 애플리케이션의 기본 공급에 참여하는 조직(또는 운영자)입니다. 비공개 대리인으로서 조직 또는 운영자는 최종 사용자의 세금을 수령하고 회계 처리할 수 있습니다. 이 상태는 세금에만 관련이 있으며 공급망에서 개발자의 법적 지위는 영향을 받지 않습니다. |
| 비공개 세금 모델 | API 제공업체가 최종 사용자에게서 징수한 세금을 차감하고 현지 세무 당국에 지급하는 세금 모델입니다. |
| 버전 | 개발자용 API 인터페이스 버전입니다. 예를 들면 pivotaltracker.com/services/v3 또는 api.enterprise.apigee.com/v1입니다. (이 용어는 API 프록시에 번들로 포함되는 구성 및 정책의 숫자가 매겨진 버전 제어 패키지인 '수정 버전'과 구별됩니다. 간단히 말해 API 인터페이스에는 버전이 있지만 API 프록시에는 수정 버전이 있습니다. |