RESTful API

1. REST API

자원(Resource), 행위(Verb),
표현(Representations)로 구성

특징
•Uniform Interface
리소스에 대한 조작을 정해진 인터페이스로 수행
•Stateless
작업을 위한 상태정보를 따로 저장하지않음
단순히 요청을 처리하는 방식이기 때문에
구현이 단순해짐
•Cacheable
HTTP 표준을 따르기때문에 캐싱 구현이 가능
(Last-Modified, E-tag)
•Self-Discriptiveness
API 메시지만 보고도 쉽게 이해할수있는
자체표현구조
•Client-Server
서버와 클라이언트별로 역할을 확실히 구분함으로써
서로의 의존성을 줄임
•계층형 구조
서버를 다중 계층 구조로 구성

디자인 가이드(중요)
•URI는 정보의 자원을 표시해야 한다
(*URI란 uniform resource identifier의 약자로
정보 리소스를 고유하게 식별하고 위치를 지정
URI의 하위 개념으로 URL, URN이 존재)
- URI 생성 규칙
1) /(슬래시) 는 계층 관계를 나타내는데 사용
2) 마지막 문자로 / 를 사용하지 않음
3) -(하이픈)은 가독성을 높이기 위해 사용
4) _(언더바)는 사용하지 않는다
5) 소문자 사용하기
6) 파일 확장자는 포함하지 않는다

•자원에 대한 행위는 HTTP Method로 표현
POST - 리소스를 생성
GET - 해당 리소스를 조회
PUT - 해당 리소스를 수정
DELETE - 리소스를 삭제

정리에 참조한 사이트

https://meetup.toast.com/posts/92