RESTful API란 무엇일까?

REST API란?

REST를 기반으로 만들어진 API를 의미합니다. 그렇다면 REST란 무엇일까요?

REST란?

• REST란 Representional State Transfer의 약자로 자원을 이름으로 구분하여 해당 자원(서버에 존재)을 상태(데이터)를 주고 받는 모든 것을 의미합니다.

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

REST의 구성요소

1. 자원- URI

• 모든 자원에는 고유한 ID가 존재하고, 이 자원은 서버에 존재합니다.
• Client는 URI를 통해 자원을 지정하고 해당 자원의 상태에 대한 조작을 서버에 요청합니다 => API호출

2. 행위(Verb) - METHOD

• HTTP Method를 이용하며 아래와 같습니다.

  GET: CRUD의 Read. 어떠한 정보를 얻을 때 사용 ex)게시글 나타낼때
  POST: CRUD의 Create. 정보를 입력하여 전달할 때 사용 ex) 게시글을 작성하고 저장할 때
  PUT: CRUD의 Update. 정보를 수정할 때 사용. ex) 게시글 수정할 때
  DELETE*: CRUD의 Delete. 정보 삭제할 때 사용. ex) 게시글 중 어떠한 게시물을 삭제할 때

3. 표현

• client와 server가 데이터를 주고받는 형태로, JSON, XML등이 잇습니다.

---

REST API

• 위에서 말한 REST의 규격을 준수하는 API를 의미합니다.

REST API를 올바르게 설계하기 위해서는 지켜야하는 몇가지 규칙이 있습니다.

1. URI는 동사보다는 명사로, 대문자보다는 소문자

   ❌ http://test.com/Testing
   ⭕ http://test.com/test

2. 언더바 대신에 하이폰(-)

   ❌ http://test.com/test_velog
   ⭕ http://test.com/test-velog

3. get,post와 같은 행위를 포함하지 않는다

   ❌ http://test.com/get/test/1
   ⭕ http://test.com/test/1

4. URI는 동사보다는 명사로, 대문자보다는 소문자

   ❌ http://test.com/Testing/
   ⭕ http://test.com/test