“REST API 완전 정복! 초보도 이해하는 서버와의 약속, REST란 무엇인가?”

📝 상세 배경 설명: REST API란?

REST(Representational State Transfer)는 웹에서 서버와 클라이언트가 데이터를 주고받는 ‘약속’ 같은 거예요.
쉽게 말하면, 서버의 자원(데이터)을 URL로 표현하고, HTTP 메서드를 써서 어떻게 다룰지 약속하는 규칙이죠.

예를 들어, 사용자의 정보를 불러올 땐 GET, 새로 만들 땐 POST, 수정할 땐 PUT이나 PATCH, 삭제할 땐 DELETE 메서드를 써서 요청해요.

REST API는 이런 규칙을 따르는 웹 API를 뜻해요.

---

💻 실무 예제 코드: REST API 기본 요청

// 사용자 목록 가져오기(GET)
fetch('https://api.example.com/users')
  .then(res => res.json())
  .then(data => console.log(data));

// 사용자 생성(POST)
fetch('https://api.example.com/users', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Alice', age: 25 })
})
.then(res => res.json())
.then(data => console.log(data));

 

⚠️ 자주 하는 실수와 해결법

💡 초보자 팁!

• REST는 ‘자원(Resource)’을 ‘URL’로 표현하고 ‘HTTP 메서드’로 조작하는 약속이다!
• API 문서를 보면 어떤 URL에 어떤 메서드를 써야 하는지 꼭 확인하자
• JSON 형식이 기본 데이터 교환 형식임을 기억하자

---

🚀 실력자 팁!

• REST API 설계 시 URI는 명사로, 메서드는 동사 역할을 한다고 생각하면 편하다
• 무조건 REST만 고집하지 말고, 상황에 따라 GraphQL, gRPC 같은 다른 방식도 고려하자
• 효율적인 REST API를 위해 캐싱, 인증, 페이징 등 부가 기능 설계도 중요하다