API 요청이 예상대로 동작하지 않을 때, Apidog는 문제를 신속하게 진단하고 해결하는 데 도움이 되는 강력한 디버깅 도구를 제공합니다. 이 가이드에서는 Apidog 콘솔을 사용하여 문제를 해결하는 방법을 설명하고, 일반적인 문제와 그 해결 방법을 안내합니다.실제 요청#
요청을 보낸 후 실제 요청 탭으로 전환하여 서버로 실제 전송된 전체 세부 정보를 확인할 수 있습니다. 여기에는 요청 URL, 헤더, 본문이 포함됩니다.이 보기는 요청이 전송되기 전에 변수, 매개변수 및 인증 세부 정보가 올바르게 해석되었는지 확인하는 데 특히 유용합니다.계속 아래로 스크롤하면 다양한 프로그래밍 언어를 사용하여 이 요청을 보내기 위한 클라이언트 코드도 확인할 수 있으며, 이를 통해 애플리케이션에서 동일한 요청을 구현하는 데 도움을 받을 수 있습니다.콘솔에서 디버깅#
요청 실행 중 언제든지 콘솔을 사용하여 로그를 출력할 수 있으며, 이를 통해 요청 또는 스크립트의 문제를 찾는 데 도움을 받을 수 있습니다. Apidog는 다음 콘솔 메서드를 지원합니다.변수 추출, 데이터베이스 작업 및 기타 자동화된 프로세스는 결과를 콘솔에 자동으로 출력하여 스크립트 실행 과정을 확인할 수 있도록 합니다.
일반적인 문제#
다음 표는 요청을 보낼 때 발생할 수 있는 일반적인 문제와 그 해결 방법을 설명합니다.| 문제 | 해결 방법 |
|---|
| 연결성 | Apidog가 요청을 보낼 수 없는 경우, 연결 문제가 있을 수 있습니다. 확인하려면 웹 브라우저에서 웹페이지를 열어 보십시오. |
| 방화벽 | 일부 방화벽은 브라우저에서 시작되지 않은 연결을 차단하도록 설정되어 있을 수 있습니다. 이 경우 Apidog가 정상적으로 작동하도록 네트워크 관리자에게 문의해야 합니다. |
| 프록시 설정 | 프록시 서버를 사용하여 요청을 보내는 경우 구성을 확인하십시오. 기본적으로 Apidog는 운영 체제의 네트워크 설정에 구성된 프록시 설정을 사용합니다. Apidog 콘솔은 프록시 서버와 관련된 디버깅 세부 정보를 제공합니다. |
| SSL 인증서 | HTTPS 연결에서 문제가 발생할 수 있습니다. 설정 아이콘을 클릭한 다음 설정 > 일반으로 이동하여 설정에서 SSL 인증서 검증을 비활성화할 수 있습니다. 이 방법으로 문제가 해결되지 않으면 서버가 클라이언트 측 SSL 연결을 사용하고 있을 수 있으며, 이는 설정 아이콘을 클릭한 다음 설정 > 인증서로 이동하여 구성할 수 있습니다. 올바른 SSL 인증서가 서버로 전송되는지 확인하려면 Apidog 콘솔을 활용하십시오. 인증서 관리에 대해 자세히 알아보십시오. |
| 클라이언트 인증서 | API 서버에 클라이언트 인증서가 필요할 수 있습니다. 설정 아이콘을 클릭한 다음 설정 > 인증서로 이동하여 설정에서 클라이언트 인증서를 추가할 수 있습니다. |
| 잘못된 요청 URL | 요청에서 변수 또는 경로 매개변수를 사용하는 경우, 실행 시 요청이 전송된 URL을 표시하는 Postman 콘솔을 확인하여 최종 주소가 정확한지 다시 확인하십시오. 해석되지 않은 요청 변수는 잘못된 서버 주소로 이어질 수 있습니다. |
| 잘못된 프로토콜 | URL에서 올바른 프로토콜(http:// 또는 https://)을 사용하고 있는지 확인하십시오. |
| 짧은 시간 제한 | Apidog에 짧은 시간 제한이 구성 되어 있으면 요청이 완료되기 전에 시간 초과되어 오류가 발생할 수 있습니다. 이를 방지하려면 설정 아이콘을 클릭한 다음 설정 > 일반으로 이동하여 설정에서 요청 시간 제한을 늘리십시오. |
| 유효하지 않은 응답 | 서버가 인코딩 오류 또는 유효하지 않은 헤더가 포함된 응답을 보내는 경우, Apidog가 이를 해석하는 데 어려움을 겪을 수 있습니다. |
| TLS 버전 | Apidog는 TLS 버전 1.2 이상을 지원하며, 이는 오래된 브라우저 또는 운영 체제와 호환되지 않을 수 있습니다. |
| Apidog 오류 | Apidog가 API 서버로 잘못된 요청을 보내고 있을 가능성이 있습니다. 서버 로그에 액세스할 수 있는 경우 이를 확인하여 검증할 수 있습니다. 이러한 상황이 의심되면 GitHub 이슈 트래커를 통해 Apidog 팀에 문의하십시오. |
| 해석되지 않은 변수 | 해석되지 않은 변수란 해당 변수가 사용된 요청에서 사용할 수 있는 범위 내에 정의되어 있지 않은 변수를 의미합니다. |
| CORS | Apidog 웹 애플리케이션에서 요청을 보내는 데 문제가 발생하는 경우, 교차 출처 리소스 공유(CORS) 오류 때문일 수 있습니다. 요청에 적합한 Apidog Agent를 사용하고 있는지 확인하십시오. 또한 Apidog Client를 사용하여 CORS 문제를 방지할 수도 있습니다. |
대부분의 디버깅 시나리오에서는 실제 요청 탭과 콘솔이 API 요청의 문제를 식별하고 해결하는 데 필요한 모든 정보를 제공합니다.