REST API (Representational State Transfer API)

웹의 장점을 최대한 활용하기 위해 설계된 소프트웨어 아키텍처 스타일인 REST 원칙을 따르는 API이다.

REST API 디자인 가이드

첫 번째, URI는 정보의 자원을 표현해야 한다.
두 번째, 자원에 대한 행위는 HTTP 메서드로 표현한다.

GET /members/update/1 (X)

PATCH /members/1 (O)

GET : /users/{userid}/devices (특정 id를 가진 유저의 device를 조회)

GET : /users/{userid}/likes/devices (특정 id를 가진 유저가 좋아하는 device를 조회)

자원은 크게 Collection과 Document로 나누어 표현할 수 있다.

http://example.com/projects

http://example.com/projects/todo-app/docs/erd

위 예시를 기준으로는 projects가 Collection이고, todo-app이 Document에 대항된다.

무상태 : 클라이언트가 서버로 보내는 각 요청에는 서버가 요청을 처리하는 데 필요한 모든 정보가 포함되어야 합니다. 서버에는 세션 상태가 저장되지 않습니다.
클라이언트-서버 아키텍처 : RESTful API는 클라이언트와 서버가 독립적으로 작동하는 클라이언트-서버 모델을 기반으로 하며, 이를 통해 확장성을 확보할 수 있습니다.
캐시 가능 : 서버 응답은 성능 향상을 위해 명시적으로 캐시 가능 또는 캐시 불가능으로 표시될 수 있습니다.
균일한 인터페이스 : REST API는 원활한 통신을 보장하기 위해 일관된 URL 경로, 표준화된 HTTP 메서드 및 상태 코드와 같은 일련의 규칙과 제약 조건을 따릅니다.
계층형 시스템 : REST API는 여러 계층에 배포할 수 있어 확장성과 보안에 도움이 됩니다.