Restful API

Restful API

(Representational State Transfer)

: A Restful API is an architectural style of an application program interface(API) that uses HTTP requests to access and use data.

-> Restful API는 데이터에 접근을 위해 HTTP 요청을 하는 인터페이스(API)의 어떤 형식인데 각 요청이 그 요청의 주소만으로도 어떤 요청인지 추정이 가능하게 만들어준다.
= API 시스템 구현을 위한 아키텍쳐 중 가장 널리 사용되는 형식

CRUD (Create 생성, Read 조회, Update 수정, Delete 삭제)
Rest API에서 주로 사용하는 HTTP 요청 method:

(GET, POST, PUT, PATCH, DELETE)
post, put, patch에는 정보들을 많이, 안전하게 보낼 수 있게 해주는 'BODY' 가 존재한다. 요청의 의도를 쉽게 파악하기 위해서 목적을 구분해서 사용하는게 좋다!
post는 주로 create할 때 사용, put과 patch는 정보를 변경할 때 사용된다.

- URI(Uniform Resource Identifier/ 유일한 주소)는 동사가 아닌 명사로! + 
  HTTP Method가 포함되면 안된다!
- HTTP Method: HTTP request가 의도한 action 정의
- Payload: HTTP request에서 server로 보내는 data (body)
- URI는 / 구분자를 사용해 자원의 계층 관계를 나타낸다. (마지막에 / nono)
  '-'는 사용하되 '_'는 사용하지 않는다 + 경로에 대문자 사용 nono

Rest API는 어떤 URI에 어떤 method를 사용할지 개발자들 사이에 지켜지는 일종의 약속으로 self-descriptiveness(API의 목적이 명백) 같은 장점이 있다.

Query parameters (GET parameters)

http://example.com/foo?p=1&q=neat
(Name= value)