[데브코스] Postman으로 API 테스트하기(GET, POST)

오늘은 HTTP 메서드 POST를 테스트할 수 있는 도구인 Postman 활용을 배웠다.

---

📬POST

데이터를 생성할 때 사용하는 메서드

GET은 데이터를 가져오는 용도였다면, POST는 데이터를 생성할 때 사용한다. 새로운 정보를 서버에 등록하거나 저장하고 싶을 때 사용한다.

 

POST API는 웹 브라우저로 테스트가 안된다?

post 메서드로 api를 만들고 실행하면 브라우저에는 다음 텍스트가 출력된다.

Cannot GET /test

브라우저 주소창은 기본적으로 GET 요청만 보낼 수 있기 때문에, POST는 테스트가 불가능하다. POST는 body에 데이터를 담아 보내는 방식이라 단순 URL 입력으로는 요청이 불가능하다.

---

🧑‍🚀Postman

POST 요청을 테스트 할 수 있는 도구

POST 요청을 테스트하기 위해 사용하는게 Postman이다. 물론 GET, DELETE, PATCH 등 다른 메서드들도 테스트 할 수 있다.
Postman에서는 요청 방식을 자유롭게 선택할 수 있고, body에 JSON 데이터를 넣어 보낼 수도 있다.

 

GET 테스트

get 테스트

POST 테스트

app.post("/test", function (req, res) {
  res.send({ message: "Hello World" });
});

원래는 body에 실어 보내야 하지만, 우선 Postman 에서의 동작 확인을 위해 위 형식으로 요청을 보냈다. send를 눌러보니, Postman에서 message가 제대로 출력되는 것을 확인할 수 있다.

post 테스트

💡Postman Tip: 자주 사용하는 요청은 저장할 수 있다 -> ctrl+s 또는 save 버튼

---

📮Post API 만들기

app.use(express.json); //body 파싱 미들웨어 
app.post('/test', function(req, res){ 
    console.log(req.body); //전체 요청 body
    console.log(req.body.message); //특정 필드 접근
    res.send(req.body.message); //메시지 그대로 응답
)

• json 미들웨어를 쓰면 request로 날아오는 바디값을 json으로 읽을 수 있다.

 

⚠️주의:잘못된 JSON 형식

지금까지 res.json으로 응답을 보낼 때는 { message: "text" }와 같은 형식으로 따옴표를 생략해도, 브라우저가 자동으로 문자열로 처리해서 출력해주었다.

 

하지만 Postman을 사용할 때는 브라우저처럼 자동으로 처리하지 않기 때문에, 정확한 JSON 형식을 지켜야 한다. 즉, { message: "text" }가 아니라 {"message":"text"} 형식으로 보내야 한다!

⭐ 항상 "key":"value" 형태로 입력

 

실습: 유튜버 등록 API

API 설계

POST /youtuber
- req: body(channelName,sub,videoNum) 

- res: channelTitle 님 유튜버 생활을 응원합니다.

app.use(express.json());
app.post("/youtuber", function (req, res) {
  const data = req.body;
  db.set(id++, req.body);
  console.log(db);

  res.json({
    mesage: `${db.get(id - 1).channelName}님의 유튜버 생활을 응원합니다.`,
  });
});

• 요청때마다 자동으로 id가 하나씩 증가하며 데이터가 저장된다.

등록 api 결과

 

전체 조회

app.get("/youtubers", function (req, res) {
  res.send(Array.from(db.values()));
});

전체 조회 결과

---

이제는 콘솔만 찍는 수준을 넘어, 점점 실제 사용자 요청 흐름을 만들어내는 느낌이 든다. 여태 Thunder Client만 썼었는데, Postman 디자인이 이뻐서 마음에 든다.