Apidog Docs
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇰🇷 한국인
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 요청 오류 수정
  • Back to home
  • 지원 센터
  • Apidog 지원 센터
  • 가져오기/내보내기
    • API 데이터를 Apidog로 가져오는 방법은 무엇입니까?
    • Apidog에서 cURL을 가져오는 방법은 무엇입니까?
    • Postman 환경을 Apidog로 마이그레이션하는 방법
    • Swagger/OpenAPI 가져오기 시 엔드포인트를 자동으로 그룹화하는 방법은 무엇입니까?
  • 요청 보내기
    • Apidog는 Socket.IO를 지원합니까?
    • 매개변수 값의 "+"가 공백으로 디코딩되는 이유는 무엇입니까?
    • Apidog에서 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 GraphQL 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 gRPC 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 SOAP/WebService 요청을 보내는 방법은 무엇입니까?
    • Apidog에서 WebSocket 요청을 보내는 방법은 무엇입니까?
    • Apidog는 WebSocket API에서 사전 요청/테스트 스크립트 및 어서션을 지원합니까?
    • Apidog에서 SSE 요청을 보내는 방법은 무엇입니까?
    • 폴더 수준에서 기본 헤더를 추가하는 방법은 무엇입니까?
    • Apidog는 gRPC API에서 사전 요청/테스트 스크립트와 어서션을 지원합니까?
    • ELANREFUSED.DNS Resolver 오류
    • 요청을 보낼 때 "socket hang up" 오류가 발생하는 이유는 무엇입니까?
    • 요청 오류 수정
      • read ECONNRESET 오류 해결하기
      • ECONNREFUSED 오류 해결
      • ETIMEDOUT 오류 해결
      • ENOTFOUND: Couldn't resolve host 오류 해결
      • ENOTFOUND 해결: getaddrinfo ENOTFOUND www 오류
      • connect EHOSTUNREACH 오류 해결
  • API 설계
    • 경로에서 변수를 어떻게 사용합니까?
    • 응답 컴포넌트를 기본 응답으로 사용할 수 있습니까?
    • 엔드포인트를 수정한 사람을 확인하는 방법은 무엇입니까?
    • Apidog에서 엔드포인트 폴더를 일괄 삭제하려면 어떻게 해야 합니까?
    • 엔드포인트의 경로에 접두사를 일괄 추가/제거하려면 어떻게 해야 합니까?
    • Schema Editor에서 Property의 수준을 이동하는 방법은 무엇입니까?
    • 문자열 속성에 여러 열거형 값이 있고 다양한 위치에서 사용되는 경우, 이 enum을 전체에서 일관되게 참조하려면 어떻게 해야 합니까?
    • Apidog 리소스 폴더 ID를 얻는 방법은 무엇입니까?
    • Apidog의 리소스 폴더 ID는 어떻게 확인합니까?
    • URL 경로에서 변수를 어떻게 사용합니까?
    • 엔드포인트, 문서 또는 테스트 시나리오가 실수로 삭제된 경우 어떻게 해야 합니까?
    • Apidog는 사용자 지정 엔드포인트에 대한 요청 코드를 지원합니까?
    • Swagger/OpenAPI를 Apidog로 가져올 때 엔드포인트를 자동으로 그룹화하는 방법은 무엇입니까?
    • 목 응답에서 중복되지 않는 배열 데이터를 생성하려면 어떻게 해야 합니까?
    • 경로에서 "#" 입력이 지원되지 않는 이유는 무엇입니까?
  • API 디버깅
    • Apidog는 타사 키 관리 시스템과 어떻게 통합됩니까?
    • 동일한 요청이 다른 도구(예: Postman)에서는 정상적으로 작동하지만 Apidog에서는 작동하지 않는 이유는 무엇입니까?
    • Apidog에서 데이터베이스로부터 변수 값을 가져오는 방법은 무엇입니까?
    • 다른 도구에서 Apidog으로 환경을 마이그레이션하는 방법은 무엇입니까?
    • Apidog에서 스크립트를 사용하여 어서션하는 방법은 무엇입니까?
    • JSONPath는 배열만 추출할 수 있습니다. Apidog에서 배열 내부의 단일 요소를 어떻게 추출할 수 있습니까?
    • 서로 다른 환경에서 데이터베이스 계정 자격 증명이 다른 경우 Apidog에서 데이터베이스 작업을 구성하는 방법은 무엇입니까?
    • 사용자 지정 스크립트에서 서비스 기본 URL을 가져오는 방법은 무엇입니까?
    • API 응답이 너무 클 때 Apidog에서 최대 Node.js 문자열 길이 초과 오류가 보고되는 이유는 무엇입니까?
    • 콘솔 출력의 크기 제한은 얼마입니까? 큰 파일을 출력할 때 오류가 발생하는 이유는 무엇입니까?
    • Windows에서 DB2 데이터베이스 연결 오류를 해결하는 방법은 무엇입니까?
    • Apidog에서 Oracle 데이터베이스에 연결할 때 NJS-045 오류가 발생하는 이유는 무엇입니까?
    • Apidog 사용자 지정 스크립트에서 동적 값을 생성하는 방법은 무엇입니까?
    • 동일한 엔드포인트에 대한 클라이언트 요청은 성공하지만, 웹 측에서 디버깅할 때 "주소를 요청할 수 없습니다" 오류가 발생하는 이유는 무엇입니까?
    • 응답이 너무 클 때 Apidog에서 오류가 보고되는 이유는 무엇입니까?
    • Apidog 기록 엔드포인트는 어떻게 사용합니까?
    • 엔드포인트 응답을 정의할 때, 엔드포인트에 응답 콘텐츠가 없어도 됩니까?
    • 사용자 지정 스크립트에서 서비스 baseURL을 어떻게 가져옵니까?
    • Apidog에서 원본 패킷을 보려면 어떻게 해야 합니까?
    • 요청을 보낼 때 "Invalid URI xxx" 오류가 표시되는 이유는 무엇입니까?
    • Apidog 스크립트에서 비동기 요청을 수행하려면 어떻게 해야 합니까?
    • 요청을 보낼 때 "Couldn't resolve host" 메시지가 표시되는 이유는 무엇입니까?
    • 콘솔 출력 크기 제한은 무엇입니까? 큰 파일을 출력할 때 왜 오류가 발생합니까?
    • 엔드포인트 요청에서 파일을 업로드하려면 어떻게 해야 합니까?
    • Apidog가 충돌하거나 응답 데이터가 표시되지 않을 때의 조치 방법
    • OAuth2.0을 위해 Apidog에서 사용하는 공식 리디렉션 URI
  • Mock API 데이터
    • API를 자동으로 목하는 방법은 무엇입니까?
    • Apidog 목 기능으로 무엇을 할 수 있습니까?
    • Apidog에서 고정 API 데이터를 목하는 방법은 무엇입니까?
    • Apidog에서 조건부 데이터를 목하는 방법은 무엇입니까?
    • Apidog에서 클라우드 목을 활성화하는 방법은 무엇입니까?
    • Apidog에서 자체 호스팅 목을 활성화하려면 어떻게 해야 합니까?
    • Apidog는 WebSocket API 목을 지원합니까?
    • 브라우저가 목 엔드포인트를 요청할 때 콘텐츠를 반환하지 않는 이유는 무엇입니까?
  • 자동 테스트
    • 로컬 클라이언트에서는 테스트 시나리오가 문제없이 실행되지만, Apidog CLI 또는 러너에서 실행할 때 오류가 발생하는 이유는 무엇입니까?
    • Apidog에서 테스트 시나리오를 생성하는 방법은 무엇입니까?
    • 테스트 단계 간에 데이터를 전달하는 방법은 무엇입니까?
    • 사전 단계 데이터를 성공적으로 참조할 수 없는 이유는 무엇입니까?
    • Apidog에서 foreach 루프를 사용하는 방법은 무엇입니까?
    • 엔드포인트/엔드포인트 케이스의 데이터 동기화에는 어떤 차이가 있습니까?
    • Apidog에서 테스트 데이터를 사용하는 방법
    • Apidog에서 스크립트로 테스트 데이터를 가져오는 방법은 무엇입니까?
    • Apidog에서 테스트 시나리오를 일괄 실행하는 방법은 무엇입니까?
    • Apidog에서 테스트 작업을 예약하는 방법은 무엇입니까?
    • Apidog에서 성능 테스트를 실행하는 방법은 무엇입니까?
    • 성능 테스트에서 실제 요청과 응답을 어떻게 확인할 수 있습니까?
    • Apidog에서 성능 테스트 보고서를 어떻게 내보낼 수 있습니까?
    • 데이터베이스 쿼리 결과를 반복 API 요청의 매개변수로 사용하는 방법은 무엇입니까?
    • CI/CD 중 ApiDog에서 Stripe 웹훅 캡처 및 검증
    • Runner에서 "Error: unable to verify the first certificate on runner" 오류를 해결하는 방법은 무엇입니까?
    • General Runner Docker 컨테이너 "Not Found" 오류.
    • Apidog 웹 버전에서 General Runner의 서버 호스트를 설정하는 방법은 무엇입니까?
    • 예약된 테스트 시나리오가 0개의 요청으로 종료된 이유는 무엇입니까?
    • Runner 또는 CLI에서 파일 업로드 매개변수를 찾을 수 없는 경우 어떻게 해야 합니까?
    • 업로드 파일 단계가 있는 테스트 시나리오를 Runner로 실행하는 방법은 무엇입니까?
    • Runner에서 "Error: unable to verify the first certificate on runner" 오류를 해결하려면 어떻게 해야 합니까?
    • Runner에 문제가 발생했을 때 문제를 식별하기 위해 Runner 로그에 접근하고 검색하려면 어떻게 해야 합니까?
    • 엔드포인트 매개변수가 업로드 파일이며 Runner 또는 CLI에서 찾을 수 없는 경우 어떻게 해야 합니까?
    • API 사용 사례가 변경될 때 테스트 단계가 자동으로 동기화되지 않는 이유는 무엇입니까?
    • Markdown 문서에서 여러 개의 달러 기호를 사용하면 일부 콘텐츠가 올바르게 표시되지 않는 이유는 무엇입니까?
    • 자체 호스팅 Runner는 작업 실행 후 서버에 테스트 보고서를 생성합니까?
    • 테스트 시나리오의 요청에 통합 사전/사후 프로세서를 추가할 수 있습니까?
    • 단일 자동화 테스트 실행 중 동적 값을 일관되게 유지하려면 어떻게 해야 합니까?
  • API 문서 게시
    • 게시된 문서에서 모든 Apidog 로고를 숨기는 방법은 무엇입니까?
    • API 사양이 업데이트되면 API 문서도 변경됩니까?
    • Apidog에서 협업자에게 API를 공유하는 방법은 무엇입니까?
    • Apidog 문서의 도메인을 사용자 지정하는 방법은 무엇입니까?
    • Apidog에서 다중 버전 문서를 생성하는 방법은 무엇입니까?
    • Apidog에서 Publish Docs Sites의 공유 범위
    • Apidog에서 Share Doc 목록의 공유 범위
    • 게시된 Share Docs에 호스트 이름이 표시되지 않는 이유는 무엇입니까?
    • 공유 문서에서 문서 사용자가 Base URL을 수정하려면 어떻게 해야 합니까?
    • 게시된 Apidog 문서를 복제하여 제 프로젝트에서 사용할 수 있습니까?
    • Apidog 온라인 문서에서 헤더(예: 토큰)를 공유하는 방법은 무엇입니까?
    • 팀원이 게시된 문서를 찾을 수 없는 이유는 무엇입니까?
    • 사용자 지정 도메인에서 SSL 인증서 만료 또는 Cloudflare 526 오류를 어떻게 해결합니까?
    • 사용자 지정 SMTP가 성공적으로 구성되었지만 허용 목록 사용자가 OTP 이메일을 받지 못함
  • Markdown
    • Apidog 내의 다양한 페이지 또는 엔드포인트에 연결하기 위해 카드를 사용하는 방법은 무엇입니까?
    • Markdown 문서에서 여러 개의 $ 기호를 사용할 때 일부 콘텐츠가 올바르게 표시되지 않는 이유는 무엇입니까?
    • Apidog Markdown에서 투명 배경 이미지를 사용하는 방법은 무엇입니까?
    • Markdown 표의 열 너비를 설정하는 방법은 무엇입니까?
    • Markdown 문서에 내부 API, 문서, 데이터 스키마 또는 폴더를 삽입하려면 어떻게 해야 합니까?
    • Apidog 카드 컴포넌트에서 프로젝트 내 문서 또는 엔드포인트에 링크를 추가하려면 어떻게 해야 합니까?
  • 브랜치
    • 스프린트 브랜치에 어떻게 접근합니까?
  • 관리
    • Apidog 클라이언트를 자동 설치하는 방법은 무엇입니까?
    • 관리자 권한이 있음에도 'No Permission' 오류가 표시되는 이유는 무엇입니까?
    • 러너 버전 번호는 어떻게 확인합니까?
    • Apidog는 Windows 7을 지원합니까?
    • Apidog 설치 후 "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" 오류가 표시되는 이유는 무엇입니까?
    • 구독 변경 및 환불
    • 웹 요청은 작동하지만 앱에서 "read ECONNRESET"이 발생하는 이유는 무엇입니까?
    • Windows 시스템 업데이트 후 Apidog을 열 수 없는 이유는 무엇입니까?
    • Windows 시스템 업데이트 후 Apidog가 열리지 않는 이유
  • 청구
    • Apidog에서 팀을 위한 별도의 결제 계정을 설정할 수 있습니까?
    • Apidog에서의 팀 액세스 및 청구 문제
    • 초대된 팀원이 Apidog에 액세스할 수 없습니다.
    • 개인 유료 팀을 조직으로 이전하기
  • 온프레미스
    • Apidog Self-Hosted(Enterprise) 버전의 사용자 및 액세스 관리
  • 웹 및 클라이언트
    • Linux 데스크톱 버전 다운로드 및 설치
  1. 요청 오류 수정

ETIMEDOUT 오류 해결

**ETIMEDOUT**는 대상 서버의 응답을 기다리는 동안 요청이 구성된 시간 제한을 초과했음을 나타냅니다.

가능한 원인#

주요 원인은 세 가지입니다.

1. 네트워크 또는 방화벽 차단#

로컬 방화벽, 백신 소프트웨어 또는 회사 네트워크 제한으로 인해 Apidog가 아웃바운드 연결을 설정하지 못하고 있습니다.

2. 서버 또는 주소 문제#

대상 서버가 실행 중이 아니거나, 연결할 수 없거나, 대상 포트가 방화벽에 의해 차단되어 있습니다.
요청한 URL 또는 IP 주소가 올바르지 않습니다.

3. Apidog 구성 문제#

요청 시간 제한이 너무 짧게 설정되어 서버가 아직 응답하지 못했습니다.
프록시 설정이 올바르지 않아 요청이 전송되지 못하고 있습니다.

해결 방법#

1. 브라우저 확장 프로그램을 설치하거나 데스크톱 앱을 사용하십시오#

웹 버전을 사용 중인 경우, 요청을 보내기 전에 브라우저 확장 프로그램을 설치하십시오. 또는 안정성을 높이기 위해 권장되는 Apidog 데스크톱 앱을 사용하십시오.

2. 시간 제한을 늘리십시오(가장 일반적)#

Apidog에서 Settings → General로 이동하여 Request timeout 값을 늘리십시오.
이미지.png

3. 네트워크 및 방화벽을 확인하십시오#

로컬 확인: 방화벽 또는 백신을 일시적으로 비활성화하여 시간 초과의 원인인지 확인하십시오.
네트워크 테스트: 회사 네트워크 제한 가능성을 배제하기 위해 다른 네트워크(예: 모바일 핫스팟)를 사용해 보십시오.

4. 서버 및 주소를 확인하십시오#

서비스 가용성 확인: 대상 서버가 실행 중이며 다른 환경에서 접근 가능한지 확인하십시오(예: 브라우저에서 URL 열기).
URL 검증: 요청 URL/IP 및 포트에 오타가 없는지 다시 확인하십시오.

5. 프록시 설정을 확인하십시오#

1.
Apidog → Settings → Network Proxy를 여십시오.
2.
적절한 조치를 취하십시오.
대상 서비스에 접근하는 데 프록시가 필요하지 않은 경우, 프록시가 비활성화되어 있거나 No proxy로 설정되어 있는지 확인하십시오.
프록시가 필요한 경우, 프록시 호스트, 포트 및 인증 자격 증명이 올바른지 확인하십시오.
이미지.png
이러한 확인 후에도 시간 초과가 지속되면 대상 서비스 소유자 또는 관리자에게 문의하고, 서버 로그 및 네트워크 구성을 점검할 수 있도록 요청 타임스탬프와 사용한 엔드포인트를 제공하십시오.
Modified at 2026-06-09 08:53:32
Previous
ECONNREFUSED 오류 해결
Next
ENOTFOUND: Couldn't resolve host 오류 해결
Built with