좋은 REST API란 무엇인가?

TODO: 서론 보강
HTTP 요청을 보내고 받는 것도 그냥 하면 안 되고, 규칙이 있더라칸다…
REST 아키텍처 스타일을 적용한 API를 가진 시스템은··· RESTful 시스템. 그냥 듣기만 해서는 개념이 머리에 붕 뜬다. REST를 정리하면서 이해하고, 더 나아가 어떻게 REST를 적용한 API가 좋은 API인지 알아보자.

— REST

Representatinal State Transfer.
웹이나 앱에서 네트워크를 통해 상태(state)를 전송(transfer)할 때, 그 내용을 잘 알 수 있는(representational) 구조로 만들어 보내는 것.

REST API

Representational State Transfer Application Programming Interface. 잘 알 수 있는 상태를 전송하는 앱을 프로그래밍할 때를 위한 인터페이스.

시스템을 RESTful 하게 만들려면?

WIP
Resource: 다루고자 하는 데이터나 정보를 의미합니다.
Resource Identification: 자원을 식별하기 위한 방법입니다.
Representation: 자원의 데이터를 전송할 때 사용하는 형식입니다.
Statelessness: 각 요청이 독립적으로 처리된다는 원칙입니다.
Client-Server Architecture: 클라이언트와 서버의 역할을 명확히 구분합니다.
Cacheability: 응답 데이터를 캐시할 수 있는지 여부를 결정합니다.
Layered System: 시스템이 여러 계층으로 구성될 수 있습니다.
Uniform Interface: 일관된 인터페이스를 제공합니다.

— 참고 자료