[250205] Postman??

Postman이란? (API 테스트 툴) 🥸

1. Postman 정의

Postman은 API 개발과 테스트를 쉽게 할 수 있도록 도와주는 API 클라이언트 도구이다
이걸 토대로 API의 요청(Request)과 응답(Response)을 손쉽게 확인할 수 있음

💡 Postman을 사용하는 이유
✔ RESTful API, GraphQL API 등 다양한 API 테스트가 가능함
✔ HTTP 요청을 쉽게 만들고, 응답을 확인할 수 있음
✔ API 요청을 자동화하고 테스트를 수행할 수 있음
✔ 여러 개의 API 요청을 Collection으로 관리가 가능함
✔ 개발자, 테스트 엔지니어, DevOps가 협업하는 데 유용함

---

2. Postman 설치 방법

✅ 설치 방법

1. Postman 공식 웹사이트 접속
2. 운영체제에 맞는 버전 다운로드 후 설치
3. 회원가입 후 로그인 (선택 사항)

---

3. Postman 기본 용어 및 기능

✅ 주요 용어

용어	설명
Request (요청)	서버에 보내는 API 요청 (GET, POST, PUT, DELETE 등)
Response (응답)	서버가 클라이언트 요청에 대해 반환하는 데이터
Collection	여러 개의 API 요청을 모아놓은 그룹
Environment	API 테스트를 위한 변수 저장 공간 (예: `{{base_url}}`)
Authorization	API 인증을 위한 로그인 토큰, API Key 등
Headers	요청과 응답에서 사용되는 메타데이터 (예: `Content-Type`)
Body	요청 본문 (JSON, XML, Form-Data 등)
Tests	응답이 정상적인지 검증하는 스크립트
Pre-request Script	요청 전에 실행되는 JavaScript 코드

---

4. Postman으로 API 테스트하기

✅ GET 요청 (데이터 조회)

1. Postman 실행 후 `+ New Request` 클릭
2. GET 메서드 선택
3. URL 입력 (예: `https://jsonplaceholder.typicode.com/posts/1`)
4. Send 버튼 클릭
5. 응답(Response) 데이터 확인

✅ POST 요청 (데이터 생성)

1. POST 메서드 선택
2. URL 입력 (예: `https://jsonplaceholder.typicode.com/posts`)
3. Body → raw → JSON 선택
4. JSON 데이터 입력
5. Send 버튼 클릭
6. 응답(Response) 데이터 확인 (새로운 데이터가 생성됨)

# JSON
{
  "title": "새로운 글",
  "body": "Postman을 사용한 API 요청",
  "userId": 1
}

✅ PUT 요청 (데이터 수정)

1. PUT 메서드 선택
2. URL 입력 (예: `https://jsonplaceholder.typicode.com/posts/1`)
3. Body → raw → JSON 선택
4. 수정할 데이터 입력
5. Send 버튼 클릭
6. 응답(Response) 데이터 확인

# JSON
{
  "id": 1,
  "title": "수정된 제목",
  "body": "수정된 내용",
  "userId": 1
}

✅ DELETE 요청 (데이터 삭제)

1. DELETE 메서드 선택
2. URL 입력 (예: `https://jsonplaceholder.typicode.com/posts/1`)
3. Send 버튼 클릭
4. 응답(Response) 상태 코드가 `200` 또는 `204`이면 정상적으로 삭제됨

---

5. Postman의 추가 기능

✅ Authorization (인증)

• API 요청 시 로그인 토큰이 필요할 경우 사용
• Bearer Token, Basic Auth, OAuth2 등 지원
• `Headers`에 Authorization 값을 추가하여 사용 가능

✅ Headers (요청 헤더 설정)

• API 요청 시 `Content-Type`을 지정할 수 있음

# JSON
{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

✅ Variables (변수 설정)

• 환경변수를 사용하여 API URL, 토큰 등을 관리 가능
• 예제: `{{base_url}}/posts/1` (환경변수 `base_url = https://jsonplaceholder.typicode.com`)

✅ Tests (응답 테스트)

• API 응답을 검증하는 자동화 테스트 작성 가능
• 예제: 응답 코드가 200인지 확인

pm.test("응답 코드가 200인지 확인", function () {
    pm.response.to.have.status(200);
});

---

6. Postman과 Django 연동

✅ Django REST Framework와 함께 사용하기

1. Django 서버 실행
2. Postman에서 `GET http://127.0.0.1:8000/api/posts/` 요청
3. 응답 데이터 확인

python manage.py runserver

✅ Django API 개발 시 Postman을 사용하면 편리하게 API를 테스트하고 디버깅이 가능함 ✅

---

포스트맨 정리:
1. Postman은 API 테스트 및 개발을 쉽게 할 수 있는 도구이다~
2. GET, POST, PUT, DELETE 요청을 쉽게 테스트 가능하다~
3. API 인증, 변수, 자동화 테스트 기능 등을 제공한다~
4. Django REST API 개발 시 매우 유용하다~