RESTFul한 API 설계

1. REST API란?

REpresentational State Transfer의 약자로, 2000년도에 Roy Fielding의 박사 논문에서 최초로 소개되었다. 로이 필딩은 HTTP 주요 저자 중 한 사람으로, 웹의 장점을 최대한 활용할 수 있는 아키텍처로써 REST를 발표했다고 한다.

2. REST의 구성

• 자원(Resource)
• 행위(Verb)
• 표현(Representations)
  쉽게 말해, REST는 URI를 통해 자원을 표시하고. HTTP Method를 이용해 자원의 행위를 규정하여 그 결과를 받는 것을 말한다.

3. REST API 설계

가장 중요한 두 가지 항목은 아래와 같다.

• URI는 정보의 자원을 표현해야 한다.
• 자원에 대한 행위는 HTTP Method로 표현한다.

3-1. 기억할 것들

• 슬래시 구분자/로 계층 관계를 나타내자
• 마지막 문자로 슬래시/를 사용하지 말자
• 언더바_ 대신 하이픈-을 쓰자
• 소문자만 사용하자
• 파일 확장자를 쓰지 말자
• 영문법을 떠나, 복수형으로 쓴다

4. 추가 자료

다들 비슷한 내용이지만 이 블로그 정리가 조금 더 이해하기 쉬운 것 같아서 추가로 남김.

https://blog.pumpkin-raccoon.com/115