3.3. 오류 메시지 구성
이 섹션에서는 APIcast 오류 메시지를 구성하는 방법에 대해 설명합니다.
프록시로서 3scale APIcast는 다음과 같은 방식으로 요청을 관리합니다.
- 오류가 없으면 APIcast는 클라이언트의 요청을 API 백엔드 서버로 전달하고 수정 없이 클라이언트에 API 응답을 반환합니다. 응답을 수정하려면 헤더 수정 정책을 사용할 수 있습니다.
-
404 Not Found또는400 Bad Request와 같은 오류 메시지로 API가 응답하면 APIcast에서 메시지를 클라이언트에 반환합니다. 그러나 APIcast에서인증 누락과 같은 다른 오류를 탐지하면 APIcast에서 오류 메시지를 전송하고 요청을 종료합니다.
따라서 APIcast에서 반환하도록 이러한 오류 메시지를 구성할 수 있습니다.
-
인증 실패: 이 오류는 false 자격 증명으로 인해 또는 애플리케이션이 일시적으로 일시 중단되었기 때문에 API 요청에 유효한 자격 증명이 포함되어 있지 않습니다. 또한 이 오류는 지표가 비활성화될 때 생성됩니다. 즉 값이
0입니다. - 인증 누락: 이 오류는 API 요청에 인증 정보가 포함되지 않을 때마다 생성됩니다. 사용자가 API 요청에 자격 증명을 추가하지 않을 때 발생합니다.
- 일치하는 항목 없음: 이 오류는 요청이 매핑 규칙과 일치하지 않으므로 메트릭이 업데이트되지 않음을 의미합니다. 이는 반드시 오류일 필요는 없지만 사용자가 임의 경로를 시도하거나 매핑 규칙이 합법적인 사례를 다루지 않음을 의미합니다.
- 사용 제한 초과: 이 오류는 클라이언트가 요청된 엔드포인트의 속도 제한에 도달했음을 나타냅니다. 요청이 여러 매핑 규칙과 일치하는 경우 클라이언트는 두 개 이상의 속도 제한에 도달할 수 있습니다.
오류를 구성하려면 다음 단계를 따르십시오.
- [your_product_name] > 통합 > 설정에서 이동합니다.
- Gateway 응답 에서 구성할 오류 유형을 선택합니다.
이러한 필드의 값을 지정합니다.
- 응답 코드: 3자리 HTTP 응답 코드.
-
컨텐츠 유형:
Content-Type헤더의 값입니다. - 응답 본문: 응답 메시지 본문의 값입니다.
- 변경 사항을 저장하려면 Update Product(제품 업데이트 )를 클릭합니다.