[Web] RESTful API 설계 원칙

RESTful API 개념

• Representational State Transfer의 약자
• 자원의 표현에 의한 상태 전달 의미
• HTTP 프로토콜 기반, 웹의 기술과 규약 그대로 활용함
• RESTful API 는 플랫폼 독립적

 

RESTful API 설계 원칙

• 자원(Resource)의 식별
  • 모든 자원은 고유한 URI를 가지며, 이를 통해 자원을 식별함
  • URI 는 인터넷상에서 자원을 고유하게 식별하고 위치를 지정하는 표준 방법
• 자원에 대한 행위는 HTTP 메서드를 통해 표현
  • HTTP 메서드 : GET, POST, PUT, DELETE
  • 자원에 대한 CRUD 연산을 명확하게 표현 가능
• 메시지는 자기 서술적
  • 메세지 포맷과 HTTP 메서드 등을 통해 요청의 의도를 명확하게 할 수 있음
• 애플리케이션의 상태는 하이퍼미디어를 통해 관리됨
  • 클라이언트는 하이퍼미디어 링크를 통해 애플리케이션의 상태를 전환할 수 있음

 

RESTful API 장점

• HTTP 프로토콜을 기반으로 하기 때문에 웹에서 널리 사용되는 기술과 호환 가능
• 플랫폼과 언어에 독립적이기 때문에 다양하게 사용 가능
• 간단하고 이해하기 쉬운 인터페이스 제공
• 확장성과 재사용성 -> Stateless 아키텍처를 따르기 때문에 서버와 클라이언트가 독립적으로 확장

 

출처

https://f-lab.kr/insight/understanding-restful-api-design-principles

RESTful API 설계 원칙 이해하기