계약 테스트는 실제 API 응답이 API 문서(OpenAPI)에 정의된 명세를 준수하는지 검증하는 데 사용됩니다. 상태 코드 및 응답 구조와 같은 콘텐츠에 대한 일관성 검사를 수행함으로써, 개발, 디버깅 및 테스트 단계에서 구현과 문서 간의 불일치를 적시에 발견할 수 있으며, 서비스 간 API 동작이 안정적이고 신뢰할 수 있도록 보장합니다.Apidog의 응답 검증(계약 테스트) 기능은 API 문서와 긴밀하게 통합되어 있습니다. 이 기능은 API 요청, 디버그 케이스, 테스트 케이스, 자동화 테스트 단계에서 사용할 수 있습니다. 기본 적으로 활성화되어 있는 핵심 기능입니다.응답 검증 활성화#
응답 검증은 모듈별로 활성화할 수 있으며, 비즈니스 요구 사항에 따라 다양한 단계에서 사용할 수 있습니다. 관련 토글은 **"설정 -> 응답 검증 설정"**에 있습니다.API 요청 및 디버그 케이스#
활성화하면 APIs 모듈 내의 "요청" 및 "디버그 케이스" 보기에서 "응답 검증" 기능을 사용할 수 있으며, 디버깅 단계에서 응답 일관성을 확인하는 데 사용됩니다.테스트 케이스#
활성화하면 APIs 모듈 내 **"테스트 케이스"**에서 "응답 검증"을 실행하여 수동 테스트 중 API 동작을 확인할 수 있습니다.자동화 테스트 단계#
활성화하면 Tests 모듈에서 "응답 검증"을 테스트 단계로 추가하여, 전체 자동화 테스트 워크플로에 응답 검증을 통합할 수 있습니다.응답 콘텐츠 검증#
Apidog의 응답 검증은 API 문서에 정의된 OpenAPI 명세를 기반으로 다음 검사를 자동으로 수행합니다.응답의 HTTP 상태 코드 검증#
실제 응답의 HTTP 상태 코드가 문서에 정의된 상태 코드와 일치하는지 확인합니다. 예를 들면 다음과 같습니다.문서에는 200으로 정의되어 있으나 실제 반환값은 204인 경우
문서에 여러 가능한 값(예: 200, 201, 400, 403)이 정의되어 있으며, 허용된 범위에 대해 검증하는 경우
응답 본문의 스키마 검증#
문서에 정의된 데이터 스키마를 기반으로 다음 콘텐츠를 검증합니다.배열 및 객체의 구조가 문서와 일치하는지 여부
객체의 추가 속성 제어#
문서에 additionalProperties가 설정되어 있지 않은 경우, 실제 응답에 문서에 정의되지 않은 추가 필드를 포함하도록 허용할지 선택할 수 있습니다.
additionalProperties가 설정되어 있는 경우, 문서의 규칙에 따라 추가 필드 허용 여부를 검증합니다.
Modified at 2026-06-09 08:53:32
