[Spring Boot] API와 REST API가 뭘까? 쉽게 설명해줌

API란?

 

API는 매개체임.

네트워크에서 프로그램 간 상호작용을 위한 매개체!

 

식당에서 음식을 주문하는걸로 예시를 들어보자면,

우리가 식당을 가서 주문할때, 주방으로 직접 가서 요리사한테 무슨 음식 만들어주세요~ 라고 안하잖아요

 

메뉴판 보고 거기 나와있는대로 주문함!!!

그리고 웨이터가 주문을 받으면, 주방에 가서 @@요리 만들어주세요~ 라고 하고

요리가 다 돼면 웨이터가 손님한테 요리를 줌.

 

여기서

손님 = 클라이언트

요리사 = 서버

웨이터 = API

라고 생각하면됨.

 

그리고 메뉴판을 API 명세서 (어떤식으로 API를 방식으로 호출하면되는지.. 매개변수 멀 넣어야하는지..등)라고 생각하면됨

 

다시 실제 상황에서 예시를 들자면,

우리가 웹사이트 네이버에 접속하는 상황.

-> 클라이언트가 url 주소창에 네이버.com을 입력 (네이버 화면 보여줘~라는 GET 요청)

-> API는 이 요청 받아서 서버에 전달

-> 서버는 API가 준 요청을 처리, 결과물 만들어서 다시 API로 전달

-> API가 최종 결과물을 브라우저에 내보내고, 우리가 네이버 메인 화면 볼 수 있는것임.

 

 

---

그렇다면 REST API는 뭘까?

 

REST API는 URL 설계 방식을 말하는거임!

rest api의 장점은 url만 보고도 뭘 하는 api인지 알 수 있다는거.

 

자원을 이름으로 구분해서 자원의 상태를 주고받음.

여기서 자원? 회원, 게시물, 댓글 등등.. 전부 자원이라고 부름.

 

그럼 자원을 이름으로 구분한다는건?

자원마다 고유한 url이 있음

예를 들면,

/members/1 -> ID가 1인 회원

/posts/2 -> ID가 2인 게시믈

이런식으로 나타내는거임.

 

그리고 자원의 상태를 주고받는다 라는 뜻은,

REST API 에서는 자원의 상태를 주고받을 때 HTTP 메소드를 이용해서 의미를 구분함

예를 들면,

1번 회원 정보를 조회할 때 : GET 메소드를 쓰고, url은 /members/1

1번 회원 정보를 삭제할 때 : DELETE 메소드를 쓰고, url은 /members/1

이런식임.

 

url같은데 괜찮냐? 괜찮음. 메소드가 달라서 구분이 되니까.

 

 

 

그리고 RESTful 하다. REST스럽지 않다. 라는 말이 있음.

이게 먼뜻이냐면,

 

RESTful 하다는건

자원 이름을 URL로 표현하고, 행위는 HTTP 메소드로 표현하는거임.

그럼 반대로 REST스럽지 않다는건

URL에 동사가 들어가 있거나, 자원 중심이 아니라 행위 중심인 경우에 그렇게 말함.

 

예를 들어

O : DELETE /posts/1 (HTTP 메소드로 뭐할건지 행위 나타내고, url에 자원이름)

X : GET /deletePosts/1 (행위 중심이라 REST 스럽지 않음)

 

 

 

--> 아무튼 결론은 REST API는 "자원 중심"의 URL 설계하고, 그 자원이 뭔 일을 할건지 행위는 HTTP메소드로 표현하면됨!!