12일차. IT 개념 정리

 

**“RESTful API 툴 구성 권고안”**을 완전 초보자도 이해할 수 있게 단계별로 아주 자세히 풀어서 설명드릴게요.
쉽게 말하면,

“RESTful API를 만들고 운영할 때, 어떤 도구(툴)를 써야 하고 왜 쓰는지를 알려주는 가이드라인”
이에요.

---

🌱 RESTful API 툴 구성 권고안 (초보자용 자세한 버전)

---

1️⃣ RESTful API란?

🔹 REST란?

REST(Representational State Transfer) 는
웹에서 데이터를 주고받는 규칙이에요.

예를 들어,

• “사용자 목록을 주세요” → GET /users
• “새 사용자를 추가할게요” → POST /users
• “이 사용자의 정보를 수정할게요” → PUT /users/1
• “이 사용자를 삭제할게요” → DELETE /users/1

이렇게 URL(주소)과 HTTP 메서드(GET, POST, PUT, DELETE)만으로 어떤 동작을 하는지 표현할 수 있는 구조를 말합니다.

그래서 RESTful API는:

“REST 규칙에 따라 데이터를 주고받는 웹 서비스”예요.

---

2️⃣ API 개발은 어떤 과정일까?

API를 만들고 실제 서비스에 올리기까지는 보통 5단계로 나눠요 👇

단계이름하는 일예시

①	설계(Design)	API 주소, 데이터 구조, 응답 형식 설계	/users/{id}, 응답 JSON 구조
②	개발(Development)	실제로 코드로 API 만들기	Spring Boot, Express 등
③	테스트(Test)	잘 동작하는지 확인	Postman, JMeter 등
④	배포(Deploy)	서버에 올리기	Docker, GitHub Actions
⑤	운영(Operation)	로그 확인, 성능 모니터링	Grafana, ELK Stack

---

3️⃣ 각 단계별로 어떤 툴을 써야 하는가?

이제부터 단계별로 추천 툴과 이유를 설명드릴게요 👇

---

🧩 ① 설계 단계 (Design Phase)

🎯 목적

• 어떤 API를 만들지 미리 설계하고, 팀원들과 공유하는 단계예요.
• “주소가 뭐고, 어떤 데이터가 들어오고 나가는지”를 미리 정합니다.

🧰 추천 툴

툴역할설명

 

Swagger Editor	API 설계	웹에서 REST API 명세(OpenAPI)를 시각적으로 설계 가능
Stoplight	협업형 설계	Swagger보다 더 시각적이고 팀 협업에 좋음
Draw.io / Lucidchart	설계 다이어그램	API 구조를 그림으로 정리할 때 사용

 

 

✅ RESTful 기준으로 보면 이렇게 됩니다 👇

기능HTTP 메서드어노테이션예시

Create (생성)	POST	@PostMapping	POST /api/users
Read (조회)	GET	@GetMapping	GET /api/users/{id}
Update (수정)	PUT	@PutMapping	PUT /api/users/{id}
Delete (삭제)	DELETE	@DeleteMapping	DELETE /api/users/{id}

---

💡 정리하자면

• ✔️ @PostMapping → 데이터 등록 (save)
• ✔️ @GetMapping → 데이터 조회 (findById, findAll)
• ✔️ @PutMapping → 데이터 수정 (update)
• ✔️ @DeleteMapping → 데이터 삭제 (delete)