REST API 란?

goyo·2022년 12월 28일
post-thumbnail

REST

REST(Representational State Transfer) 약자의 자원을 이름으로 구분하여 해당 자원의 상테를 주고받는 모든 것

즉 REST란

  1. HTTP URI를 통해 자원(Resource)를 명시하고,
  2. HTTP Method(POST,PUT,DELETE,GET)를 통해
  3. 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다.

REST 구성 요소

  • 자원(Resource) : HTTP URI
  • 자원에 대한 행위(Verb) : HTTP Method
  • 자원에 대한 행위의 내용 (Representations) : HTTP Message Pay Load

REST의 특징

  • 클라이언트 구조
  • 무상태
  • 캐시 처리 가능
  • 계층화
  • 인터페이스 일관성

 


 

REST API

REST API란 REST의 워리를 따르는 API를 의미합니다.

1.URI는 동사보다는 명사를, 대문자보다는 소문자를 사용하여야 한다.

Bad Example http://khj93.com/Running/
Good Example http://khj93.com/run/

 

2. 마지막에 슬래시 (/)를 포함하지 않는다.

Bad Example http://khj93.com/test/
Good Example http://khj93.com/test

3. 언더바 대신 하이픈을 사용한다.

Bad Example http://khj93.com/test_blog
Good Example http://khj93.com/test-blog

4. 파일확장자는 URI에 포함하지 않는다.

Bad Example http://khj93.com/photojpg
Good Example http://khj93.com/photo

5. 행위를 포함하지 않는다.

Bad Example http://khj93.com/delete-post/1
Good Example http://khj93.com/post/1

RESTful이란?

RESTful이란 REST의 원리를 따르는 시스템을 의미합니다. 하지만 REST를 사용했다하여 모두가 RESTful한 것은 아닙니다.
REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTful하다 말할 수 있으며
모든 CRUD 기능을 POST로 처리하는 API 혹은 URI 규칙을 올바르게 지키지 않은 API는 REST API의 설계 규칙을
올바르게 지키지 못한 시스템은 REST API를 사용하였지만 RESTful하지 못한 시스템이라고 할 수 있습니다.

0개의 댓글