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. 요청 만들기
  • Apidog 학습 센터
  • 시작하기
    • Apidog 소개
    • Apidog의 기본 개념
    • Apidog 탐색하기
    • 빠른 시작
      • 개요
      • 엔드포인트 생성하기
      • 요청 만들기
      • 어서션 추가하기
      • 테스트 시나리오 생성
      • API 문서 공유
      • 더 알아보기
    • Apidog로 마이그레이션
      • 개요
      • 수동 가져오기
      • 예약 가져오기(데이터 소스 바인딩)
      • 가져오기 옵션
      • 데이터 내보내기
      • 가져오기
        • Postman에서 가져오기
        • OpenAPI Spec 가져오기
        • cURL 가져오기
        • Markdown 가져오기
        • Insomnia에서 가져오기
        • apiDoc에서 가져오기
        • .har 파일 가져오기
        • WSDL 가져오기
  • Mock API 데이터
    • 개요
    • 스마트 목
    • 사용자 지정 목
    • 목 우선순위 순서
    • 목 스크립트
    • 클라우드 목
    • Self-Hosted Runner Mock
    • 목 언어(로케일)
  • 계정 및 환경설정
    • 계정 설정
    • OpenAPI 액세스 토큰 생성
    • 알림
    • 언어 설정
    • 단축키
    • 네트워크 프록시 구성
    • 데이터 백업
    • Apidog 업데이트
    • 계정 삭제
    • 실험적 기능
  • 요청 보내기
    • 개요
    • SSE 디버깅
    • MCP 클라이언트
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP 또는 WebService
    • GraphQL
    • gRPC
    • 디버깅에 요청 프록시 에이전트 사용
    • 요청 만들기
      • 요청 기록
      • 요청 기본 사항
      • 매개변수 및 본문
      • 요청 헤더
      • 요청 설정
      • 요청 디버그
      • 요청을 엔드포인트로 저장하기
      • HTTP/2
    • 인증 및 권한 부여
      • 개요
      • CA 및 클라이언트 인증서
      • 인증 유형
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 인증
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • 응답 및 쿠키
      • API 응답 보기
      • 쿠키 관리
      • 개요
  • API 개발 및 디버깅
    • 개요
    • 요청 생성
    • 요청 보내기
    • 디버깅 케이스
    • 테스트 케이스
    • 동적 값
    • 응답 검증
    • 디자인 우선 vs 요청 우선
    • 코드 생성
    • 환경 및 변수
      • 개요
      • 변수 사용하기
      • 환경 관리
    • Vault 시크릿
      • 개요
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 동적 값 모듈
      • Airline
      • 동물
      • 색상
      • Commerce
      • Company
      • 데이터베이스
      • Datatype
      • 날짜
      • 금융
      • Food
      • Git
      • Hacker
      • Helpers
      • Image
      • Internet
      • Location
      • Lorem
      • 음악
      • Number
      • Person
      • Phone
      • 과학
      • String
      • System
      • Vehicle
      • Word
    • 사전/사후 프로세서
      • 개요
      • 어서션
      • 변수 추출
      • Wait
      • 보안
      • 데이터베이스 작업
        • 개요
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • 스크립트 사용
        • 개요
        • 전처리 스크립트
        • 사후 처리 스크립트
        • Public Scripts
        • Postman 스크립트 참조
        • 다른 프로그래밍 언어 호출하기
        • JS 라이브러리 사용하기
        • 응답 시각화
        • 스크립트 예제
          • 어서션 스크립트
          • 변수 사용하기
          • 요청 수정하기
          • 기타 예시
    • API 디버깅
      • AI Agent Debugger
      • A2A Debugger
  • API 설계
    • 개요
    • 새 API 프로젝트 생성
    • 엔드포인트 기본 사항
    • API 설계 지침
    • 모듈
    • 여러 요청 본문 예시 구성
    • 컴포넌트
    • 공통 필드
    • 전역 매개변수
    • 엔드포인트 변경 이력
    • 댓글
    • 엔드포인트 일괄 관리
    • 사용자 지정 프로토콜 API
    • Spec-first 모드(Beta)
    • 보안 스키마
      • 개요
      • 보안 스키마 생성
      • 보안 스키마 사용
      • 온라인 문서의 보안 스키마
    • 고급 기능
      • 사용자 지정 엔드포인트 필드
      • 연결된 테스트 시나리오
      • 엔드포인트 상태
      • 매개변수 목록의 표시 방식
      • 엔드포인트 고유 식별
    • 스키마
      • 개요
      • 새 스키마 생성
      • 스키마 구축
      • JSON 등에서 스키마 생성
      • oneOf, allOf, anyOf
      • Discriminator 사용하기
  • API 테스트
    • 개요
    • 테스트 시나리오
      • 테스트 시나리오 생성
      • 요청 간 데이터 전달
      • 흐름 제어 조건
      • 엔드포인트 및 엔드포인트 케이스에서 데이터 동기화
      • 다른 프로젝트에서 엔드포인트 및 엔드포인트 케이스 가져오기
      • 테스트 시나리오 내보내기
    • 테스트 보고서
      • 테스트 보고서
    • 테스트 시나리오 실행
      • 테스트 시나리오 실행
      • 테스트 시나리오 일괄 실행
      • 데이터 기반 테스트
      • 공유 테스트 데이터
      • 예약 작업
      • 다른 프로젝트의 API 런타임 환경 관리
    • 테스트 스위트
      • 개요
      • 테스트 스위트 생성
      • 테스트 스위트 오케스트레이션
      • 로컬에서 테스트 스위트 실행
      • CLI를 통해 테스트 스위트 실행
      • 예약 작업
    • API 테스트
      • 통합 테스트
      • 성능 테스트
      • 엔드투엔드 테스트
      • 회귀 테스트
      • 계약 테스트
    • Apidog CLI
      • 개요
      • Apidog CLI 설치 및 실행
      • Apidog CLI 옵션
    • CI/CD
      • 개요
      • Github Actions와 통합
      • Gitlab과 통합
      • Jenkins와 통합하기
      • Git 커밋으로 테스트 트리거하기
  • API 문서 게시
    • 개요
    • 지원되는 API 기술
    • Quick Share
    • API 문서 보기
    • Markdown 문서
    • 문서 사이트 게시
    • 사용자 지정 로그인 페이지
    • 사용자 지정 레이아웃
    • 사용자 지정 CSS, JavaScript, HTML
    • 사용자 지정 도메인
    • AI 기능
    • SEO 설정
    • 고급 설정
      • 문서 검색
      • CORS 프록시
      • Google Analytics 통합
      • 폴더 트리 설정
      • 가시성 설정
      • 문서 URL에 값 임베드하기
    • API 버전
      • 개요
      • API 버전 생성
      • API 버전 게시
      • API 버전별 엔드포인트 공유
  • 브랜치
    • 개요
    • 스프린트 브랜치 생성
    • 브랜치에서 API 테스트하기
    • 브랜치에서 API 설계하기
    • 스프린트 브랜치 병합
    • 스프린트 브랜치 관리
    • AI Branch(베타)
  • AI 기능
    • 개요
    • AI 기능 활성화
    • 테스트 케이스 생성
    • AI로 스키마 수정하기
    • 엔드포인트 규정 준수 검사
    • API 문서 완성도 검사
    • AI 기반 필드 명명
    • 자주 묻는 질문
  • Apidog MCP 서버
    • 개요
    • AI에 Apidog 프로젝트 연결
    • 게시된 문서를 AI에 연결하기
    • OpenAPI 파일을 AI에 연결하기
  • 모범 사례
    • API 서명 처리
    • OAuth 2.0으로 보호되는 API에 접근하기
    • 협업 워크플로
    • 인증 상태 관리
  • 오프라인 공간
    • 개요
  • Apidog Europe
    • Apidog Europe
  • 관리
    • 프로젝트 관리
      • 프로젝트 관리
      • 알림 설정
      • 프로젝트 멤버 관리
      • 프로젝트 리소스
        • 데이터베이스 연결
        • Git 연결
    • 팀 관리
      • 팀 관리
      • 팀 멤버 관리
      • 팀 활동
      • 팀 역할 및 권한
      • 팀 리소스
        • General Runner
        • 팀 변수
        • 요청 프록시 에이전트
      • 실시간 협업
        • 팀 협업
    • 온보딩 체크리스트
      • 기본 개념
      • 온보딩 가이드
    • 조직 관리
      • 조직 관리
      • 조직 역할 및 권한
      • 플랜 관리
        • 조직의 청구 관리자
      • Single Sign-On (SSO)
        • SSO 개요
        • Microsoft Entra ID 구성
        • Okta 구성하기
        • 조직에 대한 SSO 구성
        • 사용자 계정 관리
        • 그룹을 팀에 매핑하기
      • SCIM 프로비저닝
        • SCIM 프로비저닝 소개
        • Microsoft Entra ID
        • Okta
      • 조직 리소스
        • 셀프 호스팅 Runner
  • 청구
    • 개요
    • 크레딧
    • 플랜 업그레이드
    • 대체 결제 방법
    • 구독 관리
    • 유료 팀을 조직으로 이동하기
  • 애드온
    • API Hub
    • Apidog Intellij IDEA 플러그인
    • 브라우저 확장 프로그램
      • Chrome
      • Microsoft Edge
    • 요청 프록시
      • 웹에서의 요청 프록시
      • 공유 문서의 요청 프록시
      • 클라이언트의 요청 프록시
  • 데이터 및 보안
    • 데이터 저장 및 보안
    • 사용자 데이터 개인정보 보호 및 보안
    • 요청 라우팅 및 데이터 보안
  • 참조
    • API 설계 우선 접근 방식
    • Apidog OpenAPI 사양 확장
    • JSONPath
    • XPath
    • 정규 표현식
    • JSON Schema
    • CSV 파일 형식
    • Java 환경 설치
    • Runner 배포 환경
    • Apidog Markdown 구문
    • Apidog Swagger 확장
      • 개요
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema 확장
      • 개요
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • 지원 센터
  1. 요청 만들기

요청 디버그

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 팀에 문의하십시오.
해석되지 않은 변수해석되지 않은 변수란 해당 변수가 사용된 요청에서 사용할 수 있는 범위 내에 정의되어 있지 않은 변수를 의미합니다.
CORSApidog 웹 애플리케이션에서 요청을 보내는 데 문제가 발생하는 경우, 교차 출처 리소스 공유(CORS) 오류 때문일 수 있습니다. 요청에 적합한 Apidog Agent를 사용하고 있는지 확인하십시오. 또한 Apidog Client를 사용하여 CORS 문제를 방지할 수도 있습니다.
대부분의 디버깅 시나리오에서는 실제 요청 탭과 콘솔이 API 요청의 문제를 식별하고 해결하는 데 필요한 모든 정보를 제공합니다.
Modified at 2026-06-09 08:53:32
Previous
요청 설정
Next
요청을 엔드포인트로 저장하기
Built with