7.4. 기타 문제

swagger는 petstore.swagger.io에서 호스팅되는 swagger-ui를 제공하며 최신 버전의 swagger-ui를 통해 제공되는 Swagger 사양 및 API를 테스트할 수 있습니다. swagger-ui와 ActiveDocs가 모두 동일한 방식으로 실패하는 경우 ActiveDocs 또는 ActiveDocs 프록시의 문제를 배제하고 자체 사양에서 문제 해결에 중점을 둘 수 있습니다. 또는 swagger-ui 현재 버전의 swagger-ui와 관련된 알려진 문제에 대해 swagger-ui GitHub 리포지터리를 확인할 수 있습니다.

API를 사용하는 클라이언트의 IP 주소를 허용 목록에 추가하지 않는 것이 좋습니다. ActiveDocs 프록시는 고가용성을 위해 유동 IP 주소를 사용하며 현재 이러한 IP 변경 사항을 알리는 메커니즘이 없습니다.

ActiveDocs 프록시가 올바르게 작동하는지 확인하는 한 가지 방법은 잘못된 인증 정보를 사용하여 API를 호출하는 것입니다. 이렇게 하면 ActiveDocs 프록시 및 API 게이트웨이 둘 다의 문제를 확인하거나 제외할 수 있습니다.

API 호출에서 403 코드를 다시 가져오는 경우(또는 잘못된 인증 정보에 대해 게이트웨이에서 구성한 코드에서) 호출이 게이트웨이에 도달했기 때문에 API에 문제가 발생합니다.

ActiveDocs와 ActiveDocs 외부에서 이루어진 호출 간 헤더와 매개변수의 차이점을 확인하려면 HTTP 호출을 검사 및 비교할 수 있는 일부 서비스(내부, 실행 범위 등)를 통해 호출을 실행하는 것이 도움이 될 수 있습니다. 이렇게 하면 문제가 발생할 수 있는 요청의 잠재적인 헤더 및/또는 매개변수를 식별할 수 있습니다.