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. 자동 테스트

엔드포인트/엔드포인트 케이스의 데이터 동기화에는 어떤 차이가 있습니까?

엔드포인트/엔드포인트 케이스에서 가져온 테스트 단계의 경우, 해당 요청 데이터를 연결된 엔드포인트 명세/케이스와 동기화할 수 있습니다.
데이터 동기화
엔드포인트/엔드포인트 케이스를 테스트 단계로 가져올 때 수동 또는 자동 모드를 선택할 수 있습니다.
수동 모드는 여러 사람이 협업하는 시나리오에 적합합니다. 즉, 프로젝트에서 엔드포인트 명세, 개발 및 테스트 프로세스가 모두 명확하게 역할이 구분되어 있으며 각 프로세스마다 전담 담당자가 있는 경우를 의미합니다. 이러한 프로세스에서는 의도하지 않은 변경이 서로에게 영향을 주지 않도록 데이터 독립성이 필요합니다. 엔드포인트 명세/케이스 데이터의 안정성을 확인한 후, 테스터는 이를 테스트 단계와 수동으로 동기화할 수 있습니다.
자동 모드는 소규모 팀 또는 독립 개발자에게 적합합니다. 즉, 프로젝트에서 엔드포인트 명세, 개발 및 테스트 프로세스가 모두 단일 역할에 의해 처리되어 엔드포인트 유지 관리 및 테스트 효율성을 높이는 경우를 의미합니다. "Endpoint Management"의 엔드포인트/엔드포인트 케이스가 변경되면 테스트 단계의 엔드포인트/엔드포인트 케이스 데이터도 그에 따라 조정되어 "Endpoint Management"와 "Automated Testing" 간의 데이터 일관성이 보장됩니다.
동기화 모드

동기화 관계#

테스트 단계 가져오기 방법연결된 데이터테스트 단계 동기화 모드동기화 내용
엔드포인트에서 가져오기 - 수동 모드엔드포인트 명세수동 모드(테스트 단계에서 "Update" 버튼 클릭)✅ "매개변수 이름", "Path", "Method", "사전/사후 작업" 등의 변경 사항

❌ "매개변수 값".
엔드포인트에서 가져오기 - 자동 모드엔드포인트 명세자동 모드(엔드포인트 명세가 업데이트되고 저장될 때)✅ "매개변수 이름", "Path", "Method", "사전/사후 작업" 등의 변경 사항

❌ "매개변수 값".
엔드포인트 케이스에서 가져오기 - 복사엔드포인트 명세수동 모드(테스트 단계에서 "Update" 버튼 클릭)✅ "매개변수 이름", "Path", "Method", "사전/사후 작업" 등의 변경 사항

❌ "매개변수 값".
엔드포인트 케이스에서 가져오기 - 참조엔드포인트 케이스자동 모드(엔드포인트 케이스가 업데이트되고 저장될 때)✅ 엔드포인트 케이스 데이터를 참조하며, 엔드포인트 케이스의 모든 변경 사항은 이 테스트 단계의 내용에 영향을 줍니다.

수동 동기화 모드#

수동 모드를 선택하면 연결된 버튼이 "파란색"으로 표시됩니다. "Endpoint Management"의 엔드포인트 명세에 변경 사항이 있더라도 테스트 단계의 데이터는 실시간으로 업데이트되지 않습니다. 테스터는 "Test Steps" 세부 정보에서 "Update" 버튼을 수동으로 클릭하여 엔드포인트/엔드포인트 케이스의 변경 사항을 테스트 단계와 동기화할 수 있습니다.
이 모드는 테스터가 요청 매개변수를 세부 조정해야 하는 요청이 많은 테스트 시나리오에 적합하며, 이러한 테스트 데이터에 의도치 않은 영향이 발생하는 것을 방지하고 테스트 데이터와 개발 중인 엔드포인트의 데이터 간 격리를 보장합니다.
수동 동기화
데이터 동기화
수동 모드에서는 연결된 버튼의 드롭다운 메뉴를 통해 데이터 동기화 범위를 수동으로 필터링하는 것도 지원됩니다.
동기화 필터링

엔드포인트 명세 동기화#

Endpoint → Manual update를 가져오거나 엔드포인트 케이스 → 복사에서 가져와 생성된 테스트 단계의 경우, 연결된 내용은 엔드포인트 명세입니다. 이러한 테스트 단계는 페이지의 "Sync Now" 버튼을 클릭하여 엔드포인트 명세 내용과 동기화할 수 있습니다.
수동 동기화를 트리거하면 테스트 단계는 엔드포인트 명세에서 "매개변수 이름", "사전/사후 스크립트" 등의 데이터를 동기화합니다. 동기화 대상은 엔드포인트 명세이며, 엔드포인트 명세의 요청 매개변수에 샘플 값이 설정되어 있지 않은 경우 동기화된 내용에는 "매개변수 값"이 포함되지 않습니다.
"Endpoint Spec"의 데이터를 저장하고 업데이트해도 연결된 테스트 단계에는 영향을 주지 않습니다.
엔드포인트 명세 동기화
테스트 단계에서 "Update" 버튼을 클릭하면 데이터 동기화 메커니즘이 트리거되며, 버튼에는 "Synced"라고 표시됩니다. 동기화된 데이터가 올바른지 확인한 후, 테스트 단계를 저장하려면 오른쪽 상단의 "Save" 버튼을 클릭해야 합니다.
동기화 저장

데이터 일괄 동기화#

현재 테스트 단계의 대부분 데이터가 수동 모드를 사용하고 있으며, 테스터가 이러한 엔드포인트 명세/케이스의 데이터가 올바르다는 것을 확인하고 데이터를 테스트 단계로 빠르게 동기화하려는 경우, 테스트 단계 페이지에서 "Update" 버튼을 클릭하여 일괄 동기화 작업을 수행할 수 있습니다.
일괄 동기화

자동 동기화 모드#

연결된 버튼은 주황색으로 표시됩니다. 앞서 언급한 것처럼, 이 모드는 단독 개발자가 흐름을 제어하고 직접 추적하는 데 도움이 됩니다.
자동 동기화

엔드포인트 명세 동기화#

엔드포인트 명세와 연결된 테스트 단계의 경우, 동기화 모드가 자동 동기화로 설정되어 있으면 엔드포인트 명세에 변경 사항이 있고 저장될 때 데이터가 테스트 단계에서 실시간으로 업데이트됩니다. 동기화되는 내용은 앞서 설명한 수동 동기화 모드와 동일합니다.
엔드포인트 자동 동기화
자동 모드에서는 테스트 단계의 데이터와 엔드포인트 명세 간의 불일치가 강조 표시됩니다. 테스터는 엔드포인트 명세와 완전한 일관성을 유지하기 위해 "Revert"를 선택할 수 있으며, 또는 테스트 단계의 데이터로 엔드포인트 명세의 데이터를 덮어써 일관성을 유지하기 위해 "Save to Document"를 선택할 수 있습니다.
불일치 강조 표시

엔드포인트 케이스 동기화#

테스트 단계에서 참조되는 엔드포인트 케이스의 데이터를 관리할 때 일관성과 고유성을 보장하려면, "Endpoint Management" 시스템에서 참조된 엔드포인트 케이스를 조정하여 엔드포인트 케이스와 테스트 단계가 동일한 요청 데이터를 사용하도록 해야 합니다.
테스트 단계 페이지의 안내에서 "Edit" 버튼을 클릭하면 연결된 엔드포인트 케이스 페이지로 이동하여 조정할 수 있습니다. 엔드포인트 케이스가 변경된 후 테스트 단계는 "매개변수 이름", "매개변수 값", "사전/사후 스크립트" 및 기타 모든 요청 내용을 포함하여 데이터를 자동으로 동기화합니다.
엔드포인트 케이스 동기화
Modified at 2026-06-09 08:53:32
Previous
Apidog에서 foreach 루프를 사용하는 방법은 무엇입니까?
Next
Apidog에서 테스트 데이터를 사용하는 방법
Built with