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

Apidog에서 테스트 시나리오를 생성하는 방법은 무엇입니까?

테스트 시나리오 생성#

Apidog을 열면 “Tests” 모듈로 이동한 다음, 검색창 옆의 +를 클릭하여 새 테스트 시나리오를 생성하십시오. 적절한 디렉터리를 선택하고 우선순위를 설정하여 생성을 완료하십시오.

테스트 단계 추가#

Apidog에서 테스트 시나리오를 설정한 후에는 요청으로 채우기 시작할 수 있습니다. 요청을 추가하는 방법은 여러 가지가 있으며, 각각은 다양한 요구 사항과 유연성에 맞게 설계되어 있습니다.
1.
API 사양에 연결된 요청—이러한 요청은 API 사양이 변경됨에 따라 업데이트될 수 있습니다.
a. 엔드포인트 사양에서 가져오기: 이 방법은 API 사양 내의 구조화된 정의에서 요청을 직접 가져오는 방식입니다. 테스트가 API의 문서화된 인터페이스와 일치하도록 보장하지만, 특정 테스트 조건을 충족하기 위해 요청 매개변수를 수동으로 조정해야 할 수 있습니다.
b. 엔드포인트 케이스에서 가져오기: 이 옵션을 사용하면 이미 구성된 매개변수가 포함된 사전 정의된 엔드포인트 케이스에서 요청을 가져올 수 있습니다. 실제 API 사용을 시뮬레이션하는 표준화된 테스트에 특히 유용하며, 테스트 실행 전반에 걸쳐 일관성을 유지할 수 있습니다.
2.
API 사양과 관련 없는 독립 요청—이러한 요청은 API 사양 변경에 따라 업데이트되지 않습니다. 더 높은 수준의 사용자 지정을 허용합니다.
a. 사용자 지정 요청 추가: 특정 요구 사항에 맞게 테스트 시나리오를 조정할 수 있도록 처음부터 요청을 작성하십시오. 이 접근 방식은 기존 API 사양의 범위를 넘어 탐색할 수 있는 최대한의 유연성을 제공합니다.
b. cURL에서 추가: cURL을 활용하면 사용자 지정 요청을 효율적으로 가져오거나 구성할 수 있습니다. API 사양에 제약받지 않고 복잡하거나 고유한 API 상호 작용을 모방하는 요청을 빠르게 생성하는 데 유용한 방법입니다.
3.
다른 테스트 시나리오 참조:
a. 다른 테스트 시나리오의 요청 포함: 이 방법을 사용하면 프로젝트에 이미 정의된 다른 테스트 시나리오에서 특정 요청을 가져올 수 있습니다.
b. 다른 테스트 시나리오 참조: 포괄적인 테스트를 위해 다른 테스트 시나리오 전체를 사용해야 할 수 있습니다. 이 기능을 통해 관련된 모든 테스트와 구성을 통합할 수 있으며, 설정 작업을 중복할 필요를 줄이고 통합된 테스트 전략을 촉진할 수 있습니다.

엔드포인트 사양에서 가져오기#

현재 프로젝트의 엔드포인트 사양을 테스트 시나리오의 단계로 가져올 수 있습니다. 엔드포인트를 가져올 때는 "Manual" 및 "Automated" 두 가지 모드가 있습니다. 더 자세한 지침은 Sync Data from APIs/API Cases를 참조하십시오.
Manual
"Manual" 모드에서는 프로젝트 내 엔드포인트 문서의 수정 사항이 테스트 단계의 엔드포인트에 즉시 영향을 주지 않습니다. 테스트 데이터의 동기화는 테스터가 "Manual" 버튼을 활성화할 때만 발생합니다. 테스트 단계 데이터에 적용된 변경 사항은 "Manual Sync"를 클릭하더라도 엔드포인트 문서를 업데이트하지 않는다는 점에 유의해야 합니다. 대신, 이 버튼을 클릭하면 테스트 시나리오가 동기화를 위해 엔드포인트 문서에서 정보를 가져올 수 있습니다.
Automated
"Automated" 모드에서는 프로젝트 내 엔드포인트 문서의 모든 변경 사항이 테스트 단계에 동기식으로 업데이트됩니다.
하나의 테스트 시나리오에서 다른 프로젝트의 엔드포인트를 테스트해야 하는 경우 Import Endpoints/Cases from Other Projects to Test Steps를 참조하십시오.

엔드포인트 케이스에서 가져오기#

현재 프로젝트 또는 다른 프로젝트에서 엔드포인트 케이스를 가져오도록 선택할 수 있습니다. 엔드포인트 케이스를 가져올 때는 "Copy" 및 "Reference" 두 가지 모드가 있습니다.
Copy
엔드포인트 케이스를 **"Copy"**로 가져오면 엔드포인트 케이스의 매개변수도 테스트 단계로 복사됩니다. 서로 독립적이며, 각각의 변경 사항은 다른 항목에 영향을 주지 않습니다. 수동 동기화를 선택할 수 있습니다.
Reference
엔드포인트 케이스를 **"Reference"**로 가져오면 요청에 원본 프로젝트의 엔드포인트 케이스를 직접 사용합니다.

사용자 지정 요청 추가#

작업 프로세스에서는 서드파티 결제 엔드포인트와 같이 프로젝트 외부의 엔드포인트를 호출해야 할 수 있습니다.
테스트 단계에 사용자 지정 API 요청을 추가할 수 있습니다. 사용자 지정 요청은 일반적인 GET, POST, PUT, DELETE 등을 포함한 모든 HTTP 요청일 수 있습니다.

cURL에서 추가#

실제 작업 프로세스에서는 많은 엔드포인트 요청이 cURL 명령줄 형식으로 제공됩니다. 한 번의 클릭만으로 cURL 요청을 테스트 단계로 가져올 수 있습니다.

다른 테스트 시나리오의 단계 포함#

동일한 프로젝트 내의 다른 테스트 시나리오에서 가져와 테스트 단계 또는 프로세스 제어 조건을 복제할 수 있습니다.

다른 테스트 시나리오 참조#

다른 테스트 시나리오를 테스트 단계로 참조할 수 있습니다. 사용 사례는 두 가지입니다.
1.
비즈니스 프로세스에 공통적이고 재사용 가능한 API 테스트 단계가 있는 경우, 이러한 단계를 작은 테스트 시나리오로 구성한 다음 더 넓은 다른 테스트 시나리오에서 직접 참조할 수 있습니다.
2.
전체 제품의 주요 프로세스를 회귀 테스트해야 하는 경우, 테스트 시나리오에서 다양한 하위 테스트 시나리오를 참조하여 조립하고, 한 번의 클릭으로 모든 주요 프로세스의 테스트 회귀 작업을 완료할 수 있습니다.
무한 루프 및 테스트 시나리오가 정상적으로 실행을 중지할 수 없는 상황을 방지하기 위해, 다른 테스트 시나리오를 참조하는 기능은 원본 테스트 시나리오 자체를 참조할 수 없습니다.

테스트 시나리오 오케스트레이션#

테스트 단계를 클릭하면 오케스트레이션 모드로 들어갑니다. 이 모드에서는 각 테스트 단계의 세부 내용을 더 원활하고 효율적으로 입력할 수 있도록 더 큰 작업 페이지가 제공됩니다. 페이지의 왼쪽에는 테스트 시나리오의 전체 흐름이 표시되고, 오른쪽에는 선택한 테스트 단계의 세부 정보가 표시됩니다. 엔드포인트 요청과 테스트 프로세스 제어 구성 요소는 서로 다른 표시 패널을 갖습니다.
단계 앞의 ≡를 드래그하여 단계의 순서를 조정할 수 있습니다.
이 모드에서는 "⬆️" 및 "⬇️" 키를 사용하여 선택한 테스트 단계 간에 빠르게 전환할 수 있습니다.
오케스트레이션 모드에서는 여러 단계를 편집한 다음 왼쪽 상단 모서리의 "Save All" 버튼을 클릭하여 모든 변경 사항을 저장할 수 있습니다.
저장되지 않은 변경 사항이 있는 단계가 있으면 해당 단계는 왼쪽 목록 표시줄에 점으로 표시됩니다. 변경한 사항은 항상 저장해야 한다는 점을 기억하십시오.
Modified at 2026-06-09 08:53:32
Previous
로컬 클라이언트에서는 테스트 시나리오가 문제없이 실행되지만, Apidog CLI 또는 러너에서 실행할 때 오류가 발생하는 이유는 무엇입니까?
Next
테스트 단계 간에 데이터를 전달하는 방법은 무엇입니까?
Built with