🌱 Spring Boot 시작하기 - 5. API와 RESTful 이해하기

날짜:2025-10-22

---

학습 목표

• API(Application Programming Interface)의 개념 이해
• 클라이언트와 서버가 API로 소통하는 원리 이해
• RESTful API의 특징과 설계 원칙 이해

---

✅ API 개념

📌 API(Application Programming Interface)

프로그램끼리 대화하는 방법입니다.

마치 레스토랑 메뉴판처럼, 어떤 요청을 할 수 있고 어떤 응답을 받을 수 있는지 정의합니다.

---

🔹 인터페이스로서의 API

• API의 풀네임은 Application Programming Interface
• 즉, 인터페이스(Interface) 역할
• 클라이언트와 서버는 API 명세에 따라 통신
• 내부 구현은 몰라도 API 명세만 알면 사용 가능

💡 예시: Mouse 인터페이스

Mouse m = new SamsungMouse();
m.leftClick();
m.rightClick();
m.scrollWheel();

• 클라이언트는 SamsungMouse인지 LogintechMouse인지 몰라도 된다
• 중요한 건 leftClick(), rightClick(), scrollWheel() 인터페이스 명세

---

🔹 실생활 예시

• 환율 데이터를 제공하는 API: https://open.er-api.com/v6/latest/usd
• 클라이언트는 API 호출만으로 환율 데이터를 받을 수 있음
• 백엔드 서버가 어떤 기술로 구현되었는지는 몰라도 상관 없음

💬 핵심: API는 인터페이스이므로, 구현체를 몰라도 사용할 수 있음

---

✅ RESTful API

📌 REST

클라이언트가 서버 구현을 몰라도 API를 효율적으로 사용할 수 있도록 만든 아키텍처 스타일

• RESTful = REST 원칙을 잘 지켜 설계한 API
• 반드시 지켜야 하는 규칙은 아니고, “이렇게 하면 좋다” 정도의 권장 방식

---

🔹RESTful API 특징

• URL만 보고 API 기능을 예상 가능
• 이해하기 쉽고, 유지보수와 확장이 용이

---

✅ RESTful API 디자인 원칙

1.동사보단 명사, 단수보단 복수를 사용
❌ /member/get/item/hello
✅ /members/items

2.URL 마지막에 슬래시(/)를 사용하지 않음
❌ /members/
✅ /members

3.언더바(_) 대신 하이픈(-) 사용, 대문자 사용 금지
❌ /restful_services
✅ /restful-services

4.확장자 포함하지 않기 (svg, png, exe 등)
❌ /image.svg
✅ /images

5.계층화(Layered) 구조
❌ /items/{memberId}/members/{itemId}
✅ /members/{memberId}/items/{itemId}

• 💬 핵심: RESTful API 설계는 직관적이고 이해하기 쉽게 만드는 것이 목표

---

정리

• API: 클라이언트와 서버가 소통하는 명세(인터페이스)
• RESTful API: REST 아키텍처 원칙을 적용해 직관적이고 효율적으로 설계한 API
• 설계 원칙: 명사 사용, URL 깔끔하게, 계층화 구조, 확장자 제외, 일관성 유지