REST, REST API, RESTful API

1. REST

"월드 와이드 웹과 같은 분산 하이퍼미디어 시스템을 위한 소프트웨어 아키텍처의 한 형식이다. REST는 네트워크 아키텍처 원리(자원을 정의하고 자원에 대한 주소를 지정하는 방법 전반을 일컫는다.)의 모음이다." - 위키피디아 -
무슨 말인지 모르겠다...

Representational State Transfer의 용어의 약자.
자원을 URI로 표시하고 해당 자원의 상태를 주고 받는 것을 의미한다.

REST의 요소

• Verb(행위) : HTTP Method
• Resource(자원) : URI
• Representation(표현) : 하나의 자원을 여러 형태의 Representation으로 나타내어 질 수 있다.

REST는 URI를 통해 자원을 표시하고, HTTP METHOD를 이용하여 해당 자원의 행위를 정해주며 그 결과를 받는 것을 말한다.

REST의 특징

• Uniform Interface
  HTTP 표준만 맞다면 어떤 기술도 적용 가능한 인터페이스 스타일이다.
  Java, C, IOS 플랫폼 등 특정 언어나 플랫폼에 종속되지 않고 사용이 가능

• Stateless
  client의 컨텍스트를 저장하지 않는다
  -> 세션과 쿠키와 같은 컨텍스트 정보를 신경쓰지 않아서 구현이 단순해진다.

• Cacheable
  HTTP가 가장 캐싱 기능을 적용할 수 있다.
  -> 캐시 사용을 통해 응답시간이 빨라지고 REST Server 트랜잭션이 발생하지 않기 때문에 효율이 향상된다.

• Layered System
  Client는 REST API 서버만 호출한다.

• Code-On-Demand
  Server로부터 스크립트를 받아 Client에서 실행한다.

• Server-Client
  자원을 요청하는 쪽이 Client, 자원을 가지고 있는 쪽이 Server이다.

2. REST API

REST 기반으로 서비스 API를 구현한 것.

근데 API가 뭘까?
React로 Unsplash API를 사용했던 경험은 있는데 뜻도 모르고 사용한 것 같다 😂

API란?

• 데이터와 기능의 집합을 제공하여 컴퓨터 프로그램간 상호작용과 함께 정보를 교환가능 하도록 하는 것
• 프로그램들이 서로 상호작용하는 것을 도와주는 매개체
• 특정 사이트에서 데이터를 공유할 경우 어떤 방식으로 정보를 요청해야 하는지, 그리고 어떠한 데이터를 제공 받을 수 있는지에 대한 규격

REST API의 설계 규칙 (+ 주의 사항)

• URI는 정보의 자원을 표현해야 한다. 리소스명은 동사보다는 명사를 사용.

• 자원에 대한 행위는 HTTP METHOD(POST, PUT, GET, DELETE)로 표현

• 슬래시 구분자(/)는 계층 관계를 나타내는 데 사용

• URI 마지막 문자로 슬래시(/)를 포함하지 않는다.

• 하이픈(-)은 URI 가독성을 높이는 데 사용

• 밑줄(_)은 URI에 사용하지 않는다.

• URI 경로에는 소문자가 적합하다.

• 파일 확장자는 URI에 포함시키지 않는다.

3. RESTful API

REST라는 아키텍처를 구현하는 웹 서비스를 나타내기 위해 사용되는 용어
REST를 REST답게 사용하기 위한 방법으로 누군가가 공식적으로 발표한 것이 아니다.

RESTful의 존재 이유

사용자들이 이해하기 쉬운 REST API를 만드는 것

RESTful이 아닌 경우

CRUD 기능을 전부 POST METHOD로만 처리하는 API
URI에 자원과 id정보가 들어가는 경우

4. 추가 정보

HTTP METHOD

• GET
  요청받은 URI의 정보를 검색하여 응답한다.
• POST
  요청된 자원을 생성(CREATE)한다.(새로 작성된 리소스의 경우 HTTP헤더 항목 Location:URI 주소를 포함하여 응답)
• PUT
  요청된 자원을 수정(UPDATE)한다. 클라이언트는 요청된 URI를 그대로 사용하는 것으로 간주
• DELETE
  요청된 자원을 삭제할 것을 요청함.
• PATCH
  PUT과 유사하게 요청된 자원을 수정(UPDATE)할 때 사용한다.
  PUT의 경우 자원 전체를 갱신 / PATCH는 해당 자원의 일부를 교체

첫번째 글을 마치며

첫 번째 글이라 부족한 점이 많이 있습니다!
나중에 추가 정보가 있으면 바로 업데이트 하겠습니다.
잘못 작성된 부분이 있어 언제든지 알려주신다면 바로 수정하겠습니다.