API·계약 테스트

학습 목표

이 모듈 한 줄 요약 — "화면보다 창구가 자동화하기 좋다". 화면 자동화는 버튼 위치만 바뀌어도 깨진다. 그 아래 창구(API)는 훨씬 덜 바뀌고 훨씬 빠르다. 같은 확인을 더 싸고 안정적으로 하는 자리라, 자동화를 어디에 둘지 정할 때 가장 먼저 보는 층이다.

이 모듈을 마치면 왜 API 레벨 테스트가 자동화 피라미드에서 중요한 비중을 차지하는지 이해하고, Postman으로 API 테스트를 직접 만들 수 있다. Postman의 한계를 넘어 코드 기반 자동화로 전환하는 이유를 알고, OpenAPI 기반 계약 테스트와 Pact 같은 컨슈머 주도 계약 테스트, 그리고 GraphQL 테스트의 특징까지 다룬다. 마지막으로 "테스트가 몇 개 있다"를 넘어 무엇을 얼마나 덮었는지 재는 법 — 엔드포인트·실패 경로·파라미터· 시나리오의 네 층 커버리지와 실사용 분포 대조 — 을 익힌다.

완료 후 할 수 있는 것

• API 테스트가 자동화 피라미드에서 왜 중요한 위치를 차지하는지 설명할 수 있다
• Postman으로 API 요청을 만들고 응답을 검증하는 테스트를 작성할 수 있다
• Postman에서 코드 기반 자동화로 전환해야 하는 이유와 시점을 설명할 수 있다
• OpenAPI 스펙을 기준으로 한 계약 테스트의 개념을 설명할 수 있다
• Pact 같은 컨슈머 주도 계약 테스트가 마이크로서비스 환경에서 왜 필요한지 설명할 수 있다
• REST와 다른 GraphQL API의 테스트 관점을 설명할 수 있다
• REST와 SOAP의 차이를 이해하고, SoapUI로 레거시 엔터프라이즈 API를 테스트할 수 있다
• API 커버리지를 네 층으로 나눠 측정하고, 스펙·실사용 호출량과 대조해 보강 우선순위를 정할 수 있다

채용시장에서의 위치

API 테스트는 자동화 QA·SDET 채용에서 거의 필수로 요구되는 역량이다 — UI 자동화보다 안정적이고 빠르면서도(모듈 11의 피라미드 원칙과 연결) 백엔드 로직을 직접 검증할 수 있기 때문이다. Postman은 입문용으로 가장 널리 쓰이지만, 실무 채용공고는 점점 "코드 기반 API 테스트 자동화 경험"과 "계약 테스트 경험"을 함께 요구하는 추세다. 이 모듈은 Postman에서 시작해 그 자연스러운 다음 단계까지 이어지는 성장 경로를 그대로 따라간다.

여기에 마지막 레슨이 더하는 것이 있다. 면접에서 "API 테스트 몇 개 만들어보셨어요"에 개수로 답하는 사람과, "엔드포인트 커버리지 73%, 빈칸 14개 중 호출량 상위 3개를 먼저 메웠습니다" 라고 답하는 사람은 층이 다르다. 커버리지를 재고 우선순위를 정하는 능력은 자동화 경험보다 드물다.