이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.
Apigee Edge 문서를 보세요.
다음 섹션에 설명된 대로 디버그를 사용하여 수익 창출을 디버그합니다.
인증 정책 단계 디버깅
Apigee 수익 창출은 VerifyAPIKey 또는 VerifyAccessToken 정책을 사용하여, 활성 게시 요금제를 확인하여 수신되는 요청에 대해 수익을 창출할 수 있는지 확인합니다. 정책 추가에 대한 자세한 내용은 인증 정책 추가를 참조하세요.
예를 들어 다음 이미지는 요청 흐름의 VerifyAPIKey 정책 단계 세부정보를 보여줍니다.
VerifyAPIKey 정책은 사용자를 인증한 후에 모든 게시된 요금제를 확인하여 활성화 및 만료 시간을 기준으로 활성 상태인 요금제를 확인합니다. 활성 게시 요금제가 있는 경우 다음 흐름 변수가 채워집니다.
| 흐름 변수 | 설정 |
|---|---|
mint.mintng_is_apiproduct_monetized |
true: 활성 게시 요금제가 있는 경우 |
mint.mintng_rate_plan_id |
요금제 ID입니다. |
mint.rateplan_end_time_ms |
요금제의 만료 시간입니다. 예시: 1619433556408 |
mint.rateplan_start_time_ms |
요금제의 활성화 시간입니다. 예시: 1618433956209 |
활성 게시 요금제가 없다면 mint.mintng_is_apiproduct_monetized 흐름 변수는 false로 설정되고 추가 흐름 변수가 채워지지 않습니다.
자세한 내용은 mint 흐름 변수를 참조하세요.
MonetizationLimitsCheck 정책 단계 디버깅
Apigee 수익 창출은 MonetizationLimitsCheck 정책을 사용하여 API 제품에 대해 개발자 구독을 적용합니다. 정책 추가에 대한 자세한 내용은 API 제품에 개발자 구독 적용을 참조하세요.
예를 들어 다음 이미지는 요청 흐름의 MonetizationLimitsCheck 정책 단계 세부정보를 보여줍니다.
개발자가 API 제품에 대한 구독을 구매한 경우 다음과 같은 흐름 변수가 채워집니다.
| 흐름 변수 | 설명 |
|---|---|
mint.limitscheck.is_request_blocked |
true: 차단된 요청의 경우 |
mint.limitscheck.is_subscription_found |
true: API 구독이 있는 경우 |
mint.limitscheck_purchased_product_name |
구매한 API 제품의 이름입니다. 예시: MyProduct |
mint.limitscheck.status_message |
상태 메시지입니다. 예를 들면 limits_check_success입니다. |
mint.prepaid_developer_balance |
요금제의 통화와 연결된 개발자의 선불 계정 지갑의 현재 잔액입니다. |
mint.prepaid_developer_currency |
mint.prepaid_developer_balance 변수에서 사용 가능한 잔액의 통화입니다. |
mint.subscription_end_time_ms |
API 제품 구독의 종료 시간입니다. |
mint.subscription_start_time_ms |
API 제품 구독의 시작 시간입니다. 예시: 1618433956209 |
개발자가 API 제품에 대한 구독을 구매하지 않은 경우 다음과 같은 흐름 변수가 채워집니다.
mint.limitscheck_is_subscription_found흐름 변수가false로 설정됩니다.mint.limitscheck.is_request_blocked가true로 설정됩니다.- 다른 흐름 변수는 채워지지 않습니다.
자세한 내용은 mint 흐름 변수를 참조하세요.
할당량 정책 단계 디버깅
Apigee 수익 창출은 할당량 정책을 사용하여 API 제품 수준에서 정의된 할당량을 적용합니다. 할당량은 특정 기간 동안 API 제품에 허용되는 요청 수를 정의합니다. 정책 추가에 대한 자세한 내용은 API 프록시에서 수익 창출 할당량 적용을 참조하세요.
예를 들어 다음 이미지는 할당량을 초과한 요청 흐름의 할당량 정책 단계 세부정보를 보여줍니다.
이 예시에서는 할당량이 초과되었고, HTTP 429 Too Many Requests 상태가 반환되었고, 할당량 예외에 대한 세부정보를 제공하기 위해 흐름 ratelimit.* 흐름 변수가 채워졌습니다. ratelimit.*에 대한 설명은 할당량 정책 흐름 변수를 참조하세요.
DataCapture 정책 단계 디버깅
Apigee는 수익 공유 및 애널리틱스의 평가 및 계산을 위해 DataCapture 정책에서 캡처한 수익 창출 변수를 사용합니다. 정책의 수익 창출 변수 캡처에 대한 자세한 내용은 수익 창출 데이터 캡처를 참조하세요.
예를 들어 다음 이미지는 응답 흐름에서 DataCapture 정책 실행 단계의 세부정보를 보여줍니다.
수익 창출 변수를 캡처할 때 오류가 없으면 다음 흐름 변수가 트랜잭션에 대해 채워집니다.
| 흐름 변수 | 설명 |
|---|---|
mint.mintng_currency |
수익 계산을 위한 통화입니다. 이 흐름 변수에는 |
mint.mintng_price |
개발자 공유를 계산할 수익입니다. 이 흐름 변수에는 |
mint.mintng_price_multiplier |
트랜잭션당 비용에 곱할 계수(배수)입니다. 이 흐름 변수에는 |
mint.mintng_tx_success |
트랜잭션이 수익 창출되는지를 지정합니다. 이 흐름 변수에는 |
수익 창출 API 프록시 실행 단계 디버깅
수익 창출 API 프록시가 성공적으로 실행되면 일련의 흐름 변수에 수익 창출 소비 기반 요금 및 청구된 요금에 대한 정보가 채워집니다.
예를 들어 다음 이미지는 변수가 채워진 PostClient 흐름의 프록시 실행 단계에 대한 세부정보를 보여줍니다.
수익 창출 API 프록시 실행에 성공하면 다음과 같은 흐름 변수가 채워집니다.
| 흐름 변수 | 설명 |
|---|---|
message.status.code |
대상 응답 메시지의 HTTP 상태 코드입니다.
응답에 정책이 있으면 이 변수의 값이 정책에서 반환된 상태 코드로 재정의됩니다. |
mint.limitscheck.is_request_blocked |
API 요청이 차단되었는지 여부를 지정하는 플래그입니다. |
mint.mintng_consumption_pricing_rates |
요금제에 설정된 소비 기반 요금입니다. |
mint.mintng_consumption_pricing_type |
요금제에 설정된 소비 기반 가격 책정 유형입니다. 예를 들면 FIXED_PER_UNIT입니다. |
mint.mintng_dev_share |
개발자와 공유할 수익입니다. |
mint.mintng_price_multiplier |
DataCapture 정책에서 캡처한 계수(배수)입니다. 트랜잭션당 비용에 이 계수를 곱합니다. |
mint.mintng_rate |
API 호출 요금입니다. |
mint.mintng_rate_before_multipliers |
perUnitPriceMultiplier 계산 없이 API 호출에 청구되는 요금입니다. |
mint.mintng_revenue_share_rates |
요금제에서 설정한 수익 배분율입니다. |
mint.mintng_revenue_share_type |
요금제에 설정된 수익 배분 유형입니다. |
mint.prepaid_updated_developer_usage |
선불 개발자의 현재 사용량입니다. |
mint.status |
수익 창출된 호출의 상태입니다. 오류 시에만 채워집니다. |
mint.status_code |
수익 창출된 호출의 HTTP 상태 코드입니다. 오류 시에만 채워집니다. |
mint.tx_success_result |
트랜잭션에 대해 수익 창출이 성공했는지 여부를 나타냅니다. |
모든 변수에 대한 자세한 설명은 민트 흐름 변수를 참조하세요.