3.3. 오류 메시지 구성

이 섹션에서는 APIcast 오류 메시지를 구성하는 방법에 대해 설명합니다.

프록시로서 3scale APIcast는 다음과 같은 방식으로 요청을 관리합니다.

  • 오류가 없으면 APIcast는 클라이언트의 요청을 API 백엔드 서버로 전달하고 수정 없이 클라이언트에 API 응답을 반환합니다. 응답을 수정하려면 헤더 수정 정책을 사용할 수 있습니다.
  • 404 Not Found 또는 400 Bad Request 와 같은 오류 메시지로 API가 응답하면 APIcast에서 메시지를 클라이언트에 반환합니다. 그러나 APIcast에서 인증 누락 과 같은 다른 오류를 탐지하면 APIcast에서 오류 메시지를 전송하고 요청을 종료합니다.

따라서 APIcast에서 반환하도록 이러한 오류 메시지를 구성할 수 있습니다.

  • 인증 실패: 이 오류는 false 자격 증명으로 인해 또는 애플리케이션이 일시적으로 일시 중단되었기 때문에 API 요청에 유효한 자격 증명이 포함되어 있지 않습니다. 또한 이 오류는 지표가 비활성화될 때 생성됩니다. 즉 값이 0 입니다.
  • 인증 누락: 이 오류는 API 요청에 인증 정보가 포함되지 않을 때마다 생성됩니다. 사용자가 API 요청에 자격 증명을 추가하지 않을 때 발생합니다.
  • 일치하는 항목 없음: 이 오류는 요청이 매핑 규칙과 일치하지 않으므로 메트릭이 업데이트되지 않음을 의미합니다. 이는 반드시 오류일 필요는 없지만 사용자가 임의 경로를 시도하거나 매핑 규칙이 합법적인 사례를 다루지 않음을 의미합니다.
  • 사용 제한 초과: 이 오류는 클라이언트가 요청된 엔드포인트의 속도 제한에 도달했음을 나타냅니다. 요청이 여러 매핑 규칙과 일치하는 경우 클라이언트는 두 개 이상의 속도 제한에 도달할 수 있습니다.

오류를 구성하려면 다음 단계를 따르십시오.

  1. [your_product_name] > 통합 > 설정에서 이동합니다.
  2. Gateway 응답 에서 구성할 오류 유형을 선택합니다.
  3. 이러한 필드의 값을 지정합니다.

    • 응답 코드: 3자리 HTTP 응답 코드.
    • 컨텐츠 유형: Content-Type 헤더의 값입니다.
    • 응답 본문: 응답 메시지 본문의 값입니다.
  4. 변경 사항을 저장하려면 Update Product(제품 업데이트 )를 클릭합니다.