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. API 개발 및 디버깅
  • 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는 API 사양을 활용하여 테스트 및 개발 프로세스를 간소화함으로써 API 디버깅을 직관적이고 효율적으로 수행할 수 있도록 설계된 전체 기능 모음을 제공합니다. 아래는 Apidog가 제공하는 주요 디버깅 기능의 개요입니다.

디버깅을 위한 요청 자동 생성#

Apidog는 API 사양을 기반으로 요청 매개변수와 본문 생성을 자동화하여 디버깅 프로세스의 정확성과 효율성을 높입니다.
요청 생성: API 사양에 정의된 대로 요청 매개변수와 본문을 자동으로 생성하여 테스트 중 정확성을 보장하고 시간을 절약합니다.
동적 값: 현실적이고 동적인 값을 요청에 삽입하여 실제 시나리오를 시뮬레이션하고 데이터 변형 처리 시 발생할 수 있는 잠재적 문제를 식별하는 데 도움을 줍니다.
디버깅 케이스: 요청 매개변수와 본문 구성을 재사용 가능한 엔드포인트 케이스로 저장할 수 있어 회귀 테스트와 반복 테스트를 더 효율적으로 수행할 수 있습니다.

간편한 자동 시각적 테스트#

Apidog를 사용하면 수동 설정 없이 API 응답을 시각적으로 테스트할 수 있으며, 다양한 시나리오에서 API가 예상대로 동작하는지 보장할 수 있습니다.
응답 검증: API 사양을 기준으로 API 응답을 자동으로 검증하여 불일치를 포착하고 준수 여부를 보장합니다.
시각적 어서션 테스트: 어서션을 생성하기 위한 GUI를 제공하여, 방대한 코드를 작성하지 않고도 API 응답이 충족해야 하는 조건을 더 쉽게 정의할 수 있습니다.
Postman 스크립트와의 완전한 호환성: 기존 Postman 스크립트를 Apidog로 가져와 시각적 어서션 생성 및 자동화된 테스트에 활용할 수 있으며, 기존 테스트 스위트를 유지하면서 Apidog의 고급 기능으로 강화할 수 있습니다.

경쟁 제품을 뛰어넘는 고유 기능#

Apidog는 시장에서 차별화되는 고유한 도구를 제공하며, 특히 복잡한 환경에 유용한 더 포괄적인 API 테스트를 지원합니다.
API 디버깅에서 CRUD를 위한 데이터베이스 연결: Apidog에서 데이터베이스에 직접 연결하여 API 테스트 내에서 CRUD 작업을 수행할 수 있으며, 이는 엔드투엔드 테스트와 더 복잡한 API 시퀀스에 필수적입니다.
외부 프로그래밍 언어 통합: 외부 프로그래밍 환경과 통합하여 Apidog의 기능을 확장할 수 있으며, 맞춤형 테스트 설정과 하네스를 구성할 수 있습니다.
마이크로서비스 아키텍처 지원: 마이크로서비스 아키텍처와 원활하게 작동하도록 최적화되어 강력한 지원을 제공하고, 마이크로서비스 기반 애플리케이션을 더 쉽게 관리하고 디버깅할 수 있도록 합니다.

기타 기능#

Apidog는 디버깅 방식과 API 개발 워크플로를 향상하기 위한 추가 도구와 모드도 제공합니다.
Design-First vs. Request-First: 설계 모드와 디버그 모드 간에 전환하여 API 사양 작성에 집중하거나 API 구현 디버깅에 집중할 수 있습니다.
코드 생성: 다양한 프로그래밍 언어로 코드 스니펫을 자동 생성하여 개발자가 API와 통합하거나 문제를 로컬에서 재현하는 데 도움을 줍니다.
요청에서 API 사양 자동 생성: API 사양이 오래되었거나 누락된 경우, Apidog는 요청을 기반으로 API 사양을 역공학할 수 있습니다.
Apidog의 포괄적인 디버깅 기능 모음을 활용하면 개발자는 API 테스트에 필요한 시간과 노력을 크게 줄이고, 견고하고 신뢰할 수 있으며 확장 가능한 API 솔루션을 보장할 수 있습니다.

다양한 팀을 위한 모범 사례#

API Design-First 팀의 경우#

API 설계가 완료되면 백엔드 개발 팀은 API Spec을 사용하여 API를 개발하고 디버깅할 수 있습니다. Apidog는 다음과 같은 개발 및 디버깅 기능을 제공합니다.

개발 전#

코드 생성: Apidog는 API 사양을 기반으로 다양한 프로그래밍 언어의 클라이언트 SDK, 서버 스텁, API 문서를 생성할 수 있도록 합니다. 이 자동화된 프로세스는 시간을 절약하고 API 구현 시 일관성을 보장합니다.

개발 후#

요청 생성: Apidog를 사용하면 API 사양을 기반으로 요청을 생성할 수 있습니다.
동적 값: 동적 값을 사용하면 요청을 보낼 때마다 사전 정의된 규칙을 기반으로 새 값을 생성할 수 있습니다. 이는 디버깅 프로세스를 간소화하고 각 요청에 고유한 데이터가 포함되도록 보장하는 데 도움이 됩니다.
환경 및 변수: Apidog는 다양한 환경과 서비스 구성을 지원하여 개발자가 개발, 테스트, 프로덕션 환경 설정 간에 전환할 수 있도록 합니다. 이 기능은 다양한 조건에서 API를 테스트할 때 유연성을 제공합니다.
응답 검증: 개발자는 사전 정의된 스키마 또는 기준을 기준으로 API 응답을 검증하여 API가 반환한 데이터가 예상 형식과 내용을 충족하는지 확인할 수 있습니다. 이는 API 응답 전반에서 데이터 무결성과 일관성을 유지하는 데 도움이 됩니다.
사전 및 사후 프로세서: Apidog는 API 요청이 전송되기 전과 후에 실행될 수 있는 사전 및 사후 처리 단계를 정의할 수 있도록 합니다. 이러한 작업에는 데이터 조작, 로깅, 오류 처리 또는 API 응답을 준비하거나 처리하는 데 필요한 모든 작업이 포함될 수 있습니다.
스크립팅: 개발자는 Apidog 내에서 스크립트를 작성하고 실행할 수 있어 API 개발 및 테스트 중 작업의 고급 사용자 지정과 자동화를 수행할 수 있습니다. 스크립트는 복잡한 작업 수행, 외부 시스템과의 상호 작용 또는 API 요청 및 응답 기능 향상에 사용할 수 있습니다.
디버깅 케이스: Apidog의 엔드포인트 케이스는 특정 API 엔드포인트에 대한 사전 정의된 테스트 케이스로, API 테스트의 생성, 관리, 실행 프로세스를 간소화하고 이를 자동화된 테스트 워크플로에 통합하는 데 사용됩니다.

Code-First 팀의 경우#

팀이 Code-first 개발 접근 방식을 따르는 경우, Apidog는 이 워크플로를 지원하기 위한 다양한 도구를 제공합니다.
Apidog IDEA plugin: 이 플러그인을 사용하면 코드에서 API 사양을 생성할 수 있으며, Code-first 개발 프로세스를 API 문서 생성과 원활하게 통합할 수 있습니다.
예약된 가져오기: Apidog는 Swagger에서 자동으로 동기화하는 기능을 제공하여, 코드에서 발생한 변경 사항이 API 문서에 최신 상태로 반영되도록 보장합니다.
Design-First vs. Request-First: 디버깅 모드 기능을 사용하면 디버깅 중 API 사양을 실시간으로 수정할 수 있어, 코드를 개발하고 테스트하는 과정에서 API 설계를 반복적으로 개선할 수 있습니다.
동적 값: 동적 값을 사용하면 요청을 보낼 때마다 사전 정의된 규칙을 기반으로 새 값을 생성할 수 있습니다. 이는 디버깅 프로세스를 간소화하고 각 요청에 고유한 데이터가 포함되도록 보장하는 데 도움이 됩니다.
환경 및 변수: Apidog는 다양한 환경과 서비스 구성을 지원하여 개발자가 개발, 테스트, 프로덕션 환경 설정 간에 전환할 수 있도록 합니다. 이 기능은 다양한 조건에서 API를 테스트할 때 유연성을 제공합니다.
사전 및 사후 프로세서: Apidog는 API 요청이 전송되기 전과 후에 실행될 수 있는 사전 및 사후 처리 단계를 정의할 수 있도록 합니다. 이러한 작업에는 데이터 조작, 로깅, 오류 처리 또는 API 응답을 준비하거나 처리하는 데 필요한 모든 작업이 포함될 수 있습니다.
스크립팅: 개발자는 Apidog 내에서 스크립트를 작성하고 실행할 수 있어 API 개발 및 테스트 중 작업의 고급 사용자 지정과 자동화를 수행할 수 있습니다. 스크립트는 복잡한 작업 수행, 외부 시스템과의 상호 작용 또는 API 요청 및 응답 기능 향상에 사용할 수 있습니다.
디버깅 케이스: Apidog의 엔드포인트 케이스는 특정 API 엔드포인트에 대한 사전 정의된 테스트 케이스로, API 테스트의 생성, 관리, 실행 프로세스를 간소화하고 이를 자동화된 테스트 워크플로에 통합하는 데 사용됩니다.
Modified at 2026-06-09 08:53:32
Previous
개요
Next
요청 생성
Built with