[Spring] REST와 API 그리고 REST API란?

 

 

Swagger를 통해
API의 명세서를 만들어보려했다.

그런데 REST API와 연관이 있는 듯 하다.
REST API가 뭘까?

 

 

 

 

 

REST란?

• REST는 Representational State Transfer의 약자이다.
• 자원을 이름으로 구분하여 해당 자원의 상태를 주고 받는 모든 것을 의미한다.
• HTTP URI를 통해 자원을 명시하고, HTTP Method(GET, POST 등)를 통해 해당 자원(URI)에 대한 기본적인 데이터 처리 기능들을 적용한다.
• 여기서 기본적인 데이터 처리 기능은 CRUD Operation으로 Create(생성), Read(읽기), Update(갱신), Delete(삭제)를 말한다.

 

 

 

REST의 단점

• 표준 자체가 존재하지 않아 정의가 필요하다.
• HTTP Method 형태가 제한적이다.
• 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야 하므로 전문성이 요구된다.

 

 

 

API란?

• API는 Application Programming Interface의 약자이다.
• 소프트웨어 어플리케이션들이 서로 통신하고 상호작용할 수 있도록 하는 규칙, 프로토콜, 도구들의 집합이다.
• 응용 프로그램에서 사용할 수 있도록, 운영 체제나 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스를 뜻한다.
• 웹 API는 클라이언트와 웹 리소스 사이의 네트워크 통신을 위한 게이트웨이다.

 

 

 

REST API란?

• REST라는 설계 원칙에 따라 만든 실제 API
• 예를 들어, /hello라는 URL로 GET 요청을 보내면 hello라는 글자를 보여주는 식으로 HTTP 메서드(GET, POST 등)와 URL 조합을 통해 데이터를 주고받는 방식이다.
• REST API는 API를 이런 식으로 만들자는 약속이다.

출처: https://www.skiplevel.co/blog/part-2-rest-api-components-how-to-read-them

 

 

• HTTP Request에는 엔드포인트, HTTP 메서드, Request Headers, Request Body가 있다.
• HTTP Response에는 상태 코드, Response Headers, Response Body가 있다.

 

 

---

 

 

아래에 출처를 남겨두겠습니다.
블로그엔 제가 최대한 이해한 내용까지만 적는거라
출처에 들어가시면 더 많은 내용이 있어 공부하시는데 도움되실겁니다.

 

🪽

틀린 내용이 있다면 댓글로 알려주세요

 

 

---

 

 

- REST API

[네트워크] REST API란? REST, RESTful이란?

 

 

- REST API

[Part 2] REST API components & How to read them

 

 

- API

API란 무엇일까? API 쉽게 이해하기

 

 

- REST API

REST, RESTful API란? 개념 살펴보기