REST API의 핵심 규칙
- 클라이언트-서버 구조(Client-Server Architecture): 클라이언트와 서버는 서로 독립적으로 작동해야 합니다. 이를 통해 각각의 부분을 독립적으로 개발하고 확장할 수 있습니다.
- 무상태성(Stateless): 각 요청은 독립적이며, 이전 요청에 대한 정보를 저장하지 않습니다. 모든 요청은 필요한 모든 정보(예: 사용자 인증)를 포함해야 합니다.
- 캐시 가능(Cacheable): 클라이언트는 응답을 캐시할 수 있어야 하며, 서버 응답은 캐시가 가능한지 여부를 명시해야 합니다. 이를 통해 클라이언트가 재사용 가능한 데이터를 재요청 없이 사용할 수 있습니다.
- 계층화된 시스템(Layered System): 클라이언트는 서버가 하나인지, 중간 서버를 통해 데이터를 받는지 알 필요가 없습니다. 중간 레이어는 로드 밸런싱이나 공유 캐시 등을 제공할 수 있습니다.
- 코드 온 디맨드(Code on Demand, 선택적): 서버는 실행 가능한 코드를 클라이언트에게 전송할 수 있어야 합니다(예: JavaScript).
- 표준화된 인터페이스(Uniform Interface): 시스템의 다른 부분 간 통일된 인터페이스가 있어야 합니다. 이는 REST API를 사용하는 데 있어 가장 중요한 원칙 중 하나로, 자원의 식별, 자원에 대한 표현, 자체 설명적 메시지, HATEOAS(Hypertext As The Engine Of Application State) 등을 포함합니다.
결론
개발자가 이러한 원칙을 따라 API를 설계하고 구현했다면, 그 API는 "RESTful"이라고 할 수 있습니다. RESTful API는 인터넷 상에서 데이터를 교환하기 위한 효과적이고 유연한 방법을 제공하며, 웹 서비스 개발에서 널리 사용되고 있습니다.
정진하는개발자