(4주 4일차) 코딩 없이 시작! Postman으로 나의 첫 API 테스트

 

POSTMAN 으로 API 테스트를 해보자.

 

안녕하세요! QA여행 ( https://qajourney.tistory.com/ ) 입니다.

챌린지 22일차에 오신 여러분을 환영합니다.

 

어제 우리는 테스트 자동화의 필요성과 그 장단점에 대해 알아보았죠.

오늘은 '코딩'이라는 장벽 없이도 자동화의 맛을 볼 수 있는 아주 강력하고 유용한 도구인,

Postman(포스트맨)을 통해 API 테스트의 세계에 첫발을 내디뎌 보겠습니다.

'API'라는 단어가 낯설게 느껴질 수 있지만,

오늘 저와 함께 차근차근 따라오시면 "아, 이게 API구나!" 하고 쉽게 이해하실 수 있을 거예요.

 

API가 도대체 뭔가요? 

API(Application Programming Interface)를 가장 쉽게 비유하자면, 식당의 '웨이터' 와 같습니다.

1. 손님(나, 클라이언트) : "파스타 하나 주세요!" 라고 주문(요청)합니다.
2. 웨이터(API) : 손님의 주문을 받아 주방(서버)에 정확히 전달합니다.
3. 주방(서버) : 주문에 맞춰 파스타를 요리합니다.
4. 웨이터(API) : 완성된 파스타(데이터)를 손님에게 가져다줍니다(응답).

이처럼 API는

사용자 인터페이스(UI) 뒤에서 애플리케이션의 서로 다른 부분들이 서로 소통할 수 있도록 연결해주는 '중간 다리' 역할을 합니다.

우리가 보는 화면(프론트엔드)은 이 API를 통해 보이지 않는 서버(백엔드)의 데이터와 기능을 가져와 보여주는 것이죠.

 

왜 API를 테스트해야 할까요?

화면(UI)이 완성되기 전에도 백엔드 기능이 제대로 동작하는지 미리 테스트할 수 있고,

화면의 변화와 상관없이 핵심 로직을 직접 검증할 수 있기 때문입니다.

이는 UI 테스트보다 훨씬 빠르고 안정적이며, 문제의 원인을 더 정확하게 파악하는 데 도움을 줍니다.

Postman은 바로 이 API가 잘 작동하는지, 우리가 보낸 요청에 대해 올바른 응답을 주는지

쉽고 편리하게 테스트할 수 있도록 도와주는 대표적인 API 개발 도구입니다.

• 추천 링크 : Postman 공식 웹사이트 및 다운로드

 

실습 : 나의 첫 API 테스트 (GET 요청 보내기)

자, 그럼 Postman을 설치했다는 가정 하에, 세상에서 가장 간단한 API 테스트를 함께 해볼까요?

우리는 'REST Countries'라는 공개 API를 사용해서 특정 국가의 정보를 요청해 보겠습니다.

 

1. Postman 실행 및 새 요청(Request) 생성 Postman을 열고 '+' 버튼을 눌러 새 탭을 엽니다.

2. 요청 정보 입력

• HTTP 메소드 선택: 드롭다운 메뉴에서 GET 을 선택합니다. GET은 서버로부터 정보를 '가져오기(조회하기)' 위한 요청입니다.
• URL 입력 : 주소창에 https://restcountries.com/v3.1/name/korea 를 입력합니다. 이는 "restcountries 서버야, 이름(name)이 korea인 국가의 정보를 줘!" 라는 의미의 요청 주소입니다.

3. 'Send' 버튼 클릭하여 요청 보내기 파란색 'Send' 버튼을 클릭합니다. 우리는 지금 '웨이터'에게 주문을 넣은 것입니다!

4. 응답(Response) 확인 잠시 후, 아래쪽 'Response' 창에 서버로부터 받은 응답 결과가 표시됩니다. 만약 Status: 200 OK 라고 표시된다면, 요청이 성공적으로 처리되었다는 의미입니다.

Body 탭을 보면, 대한민국의 수도(capital), 인구(population), 사용하는 언어(languages) 등의 정보가 JSON(제이슨) 이라는 형식의 텍스트로 예쁘게 정리되어 도착한 것을 확인할 수 있습니다.

JSON

 

[
    {
        "name": {
            "common": "South Korea",
            "official": "Republic of Korea",
            ...
        },
        "capital": [
            "Seoul"
        ],
        "region": "Asia",
        ...
    }
]

 

마무리하며

축하합니다!

여러분은 방금 코딩 한 줄 없이 API를 직접 호출하고, 서버와 통신하여 데이터를 받아오는 'API 테스트'를 성공적으로 수행하셨습니다.

오늘 실습한 GET 요청 외에도

서버에 데이터를 생성(POST), 수정(PUT), 삭제(DELETE)하는 등 다양한 API 테스트를 Postman으로 수행할 수 있습니다.

API 테스트는 수동 테스트의 한계를 넘어, 보이지 않는 시스템의 내부 로직까지 검증할 수 있게 해주는 QA의 강력한 무기입니다.

오늘 느낀 이 경험이 여러분의 기술적인 성장에 대한 자신감으로 이어지기를 바랍니다.

오늘도 새로운 도전에 성공하신 여러분, 정말 고생 많으셨습니다!

 

내일 23일차에는 드디어 우리의 최종 목적지,

<신입 QA, 무엇부터 준비해야 할까?>라는 주제로 QA 포트폴리오 구성법과

기술 면접 단골 질문에 대해 알아보며 취업 준비의 첫 단추를 끼워보겠습니다.

그럼 편안한 저녁 보내시고, 내일 뵙겠습니다!