Restful-API 언제, 어떻게 사용하나요?

[daumi125]

🤔

[daumi125]

✅ Restful API를

언제 사용하는가

• 서버와 클라이언트가 분리된 구조를 만들고 싶을 때 사용합니다.
  • 예: 프론트엔드(React, Vue 등)와 백엔드(Spring)가 따로 개발될 때
• 모바일 앱, 웹 등 다양한 플랫폼에서 같은 서버 API를 사용하고 싶을 때
• HTTP 통신을 이용해 명확하고 일관된 방식으로 리소스를 다루고 싶을 때
• 확장성과 유지보수성이 중요한 대규모 시스템을 개발할 때

✅ Restful API를

어떻게 사용하는가

• 리소스(Resource) 를 URI로 표현합니다. 예: /users, /users/1
• HTTP 메서드(Method) 로 리소스에 대한 행위를 구분합니다.
  • GET: 리소스 조회
  • POST: 리소스 생성
  • PUT: 리소스 전체 수정
  • PATCH: 리소스 일부 수정
  • DELETE: 리소스 삭제
• HTTP 상태 코드(Status Code) 로 결과를 명확하게 전달합니다.
  • 200 OK, 201 Created, 404 Not Found, 500 Internal Server Error 등
• Stateless(무상태성) 으로 동작합니다.
  • 서버는 요청 간 클라이언트의 상태를 저장하지 않고, 요청마다 필요한 정보를 모두 받아 처리합니다.

✅ Restful API를 사용하는

이점

항목	내용
표준화	규칙이 명확하여 누구나 API를 쉽게 이해하고 사용할 수 있습니다.
유연성	하나의 서버 API로 웹, 앱, 다른 외부 시스템에서도 쉽게 연동할 수 있습니다.
확장성	새로운 기능 추가나 시스템 변경이 쉬워집니다.
분리와 독립성	프론트엔드, 백엔드가 독립적으로 개발되고 테스트할 수 있습니다.
유지보수 용이	리소스 기반 설계로 변경사항 관리가 쉬워집니다.
캐시 처리 용이	HTTP의 GET 요청은 캐싱이 가능하여 성능 향상에 유리합니다.

[daumi125]

✅ Restful API를 사용하는 이유
"서버와 클라이언트를 분리해 독립적으로 개발하고, 다양한 플랫폼에서 일관된 방식으로 데이터를 주고받기 위해 사용합니다."

✅ Restful API를 사용하는 방식
"URI로 자원을 표현하고, HTTP 메서드(GET, POST, PUT, DELETE)로 행위를 구분하여, 요청과 응답을 표준화된 형식으로 주고받습니다."

✅ Restful API의 이점
"표준화된 설계로 이해와 유지보수가 쉬우며, 확장성과 유연성이 뛰어나고, 다양한 시스템과 연동이 용이합니다."

✅ Spring에서의 사용 예시
"Spring에서는 @RestController, @RequestMapping, @GetMapping 등을 사용해 URI와 HTTP 메서드에 따라 자원을 처리하는 API를 간단히 구현할 수 있습니다."