[Network] REST API, HTTP Method

[ REST ]

REpresentational State Transfer의 약자로,
웹에 존재하는 자원에 고유한 URI를 부여하고 해당 자원의 상태를 주고받는 것을 말한다.

💡 REST의 가장 큰 특징은 각 요청이 어떤 동작이나 정보를 위한 것인지를 그 요청의 모습만으로도 추론이 가능하다는 것이다!

REST 구성

1. 자원(Resource): URI(Uniform Resource Identifier)

• 서버는 고유한 ID를 갖는 자원을 가지며, 클라이언트는 이러한 자원에 요청을 보낸다.
• 이러한 자원을 URI라고 한다.

2. 행위(Verb): HTTP Method

• 서버에 요청을 보내기 위한 방식이다.
• 클라이언트는 URI를 이용해 자원을 지정하고 자원을 조작하기 위해 Method를 사용한다.
• HTTP 프로토콜에서는 GET, POST, PUT, DELETE 등과 같은 Method를 제공한다.

3. 표현(Representations)

• 클라이언트가 서버로 요청을 보냈을 때 서버가 응답으로 보내주는 자원의 상태를 말한다.
• REST에서 하나의 자원은 JSON, XML, TEXT, RSS 등 여러 형태의 Representation으로 나타낼 수 있다.

REST 특징

1. 클라이언트/서버 구조 (Client-Server)

• 자원이 있는 Server, 자원을 요청하는 Client의 구조를 가진다.

2. 무상태(Stateless)

• HTTP는 stateless 프로토콜이므로 REST 역시 무상태성을 가진다.
• 클라이언트의 Context를 서버에 저장하지 않는다.

3. 캐시 처리 기능(Cacheable)

• 웹 표준 HTTP 프로토콜을 그대로 사용하므로, 웹에서 사용하는 기존의 인프라를 그대로 활용 가능하다.

4. 계층화

• API 서버는 순수 비지니스 로직을 수행하고 그 앞단에 사용자 인증, 암호화, 로드밸런싱 등을 하는 계층을 추가하여 구조상의 유연성을 줄 수 있다.

5. 인터페이스 일관성(Uniform Interface)

• URI로 지정한 자원에 대한 조작을 통일되고 한정적인 인터페이스로 수행한다. HTTP 표준에만 따른다면 모든 플랫폼에 사용 가능하다.

6. 자체 표현 구조

• 동사(Method) + 명사(URI)로 이루어져 있어 어떤 메서드에 무슨 행위를 하는지 알 수 있으며 REST API 자체가 매우 쉬워서 API 메시지 자체만 보고도 API를 이해할 수 있다.

REST 장단점

1. 장점

• 쉬운 사용
  • HTTP 프로토콜 인프라를 그대로 사용하므로 별도의 인프라를 구축할 필요가 없다.
• 클라이언트-서버 역할의 명확한 분리
  • 클라이언트는 REST API를 통해 서버와 정보를 주고 받는다.
  • REST의 특징인 Stateless에 따라 서버는 클라이언트의 Context를 유지할 필요가 없다.
• 특정 데이터 표현을 사용 가능
  • REST API는 헤더 부분에 URI 처리 메서드를 명시하고 필요한 실제 데이터를 body에 표현할 수 있도록 분리시켰다. JSON, XML 등 원하는 Representation 언어로 사용 가능하다.

2. 단점

• 메서드의 한계
  • REST는 HTTP 메서드를 이용하여 URI를 표현한다. 이러한 표현은 쉬운 사용이 가능하다는 장점이 있지만, 반대로 메서드 형태가 제한적인 단점이 있다.
• 표준이 없다.
  • REST는 설계 가이드일 뿐이지 표준이 아니다. 명확한 표준이 없다.

---

[ REST API, RESTful API ]

✅ API란?

• Application Programming Interface의 약자로,
• 소프트웨어가 다른 소프트웨어로부터 지정된 형식으로 요청, 명령을 받을 수 있는 수단을 말한다.

✅ REST API란?

• REST 특징을 기반으로 서비스 API를 구현한 것이다.
• HTTP 표준을 기반으로 구현하기 때문에 HTTP를 지원하는 프로그래밍 언어를 사용하여 클라이언트와 서버를 구현할 수 있다.

✅ RESTful API란?

• REST의 설계 규칙을 잘 지켜서 설계된 API를 뜻한다.

✅ RESTful API의 URI 설계 규칙

• 소문자 사용(최소한 대소문자 구분)
• 하이픈(-) 사용: 공백 제거
• 확장자 사용 지양: 헤더에 값을 넣는다.
• CRUD는 URI에 사용해서는 안 된다.

---

[ HTTP Method ]

클라이언트가 웹 서버에게 사용자 요청의 목적이나 종류를 알리는 수단이다.

1. GET

주로 데이터를 읽거나 검색할 때 사용한다.

• 가장 많이 사용된다.
• 서버에 전달하고 싶은 데이터는 query(쿼리 파라미터, 쿼리 스트링)를 통해 전달한다.

2. POST

요청된 자원을 생성한다.

• 새 리소스 생성(등록)
  • 서버가 아직 식별하지 않은 새 리소스를 생성한다.
• 요청 데이터 처리
  • 단순히 데이터를 생성하거나, 변경하는 것을 넘어서 프로세스를 처리해야 하는 경우에 사용한다.
  • 서버는 메시지 바디를 통해 들어온 데이터를 처리한다.
• 다른 메서드로 처리하기 어려운 경우
  • json으로 조회 데이터를 넘겨야 하는 GET 메서드를 사용하기 어려운 경우와 같이 애매한 경우 POST를 사용한다.
    
    

3. PUT

리소스를 완전히 대체한다.

• 리소스가 있으면 대체하고, 없으면 생성한다.
• 클라이언트가 리소스를 식별한다.
  • 클라이언트가 리소스 위치를 알고 URI를 식별한다.

4. PATCH

리소스의 일부를 변경한다.

• PUT과 비슷하지만, 부분적으로만 수정하고 싶은 경우 사용한다.
• PATCH를 지원하지 않는다면, POST를 사용하면 된다.

5. DELETE

요청된 자원의 삭제를 요청한다.

---

[ 참고자료 ]

http://www.incodom.kr/REST
https://www.youtube.com/watch?v=iOueE9AXDQQ
https://mangkyu.tistory.com/46
https://dev-coco.tistory.com/97