REST API란?

REST

REST 정의

• Representational State Transfer(대표적인 상태 전달)의 약자
• 월드 와이드 웹(www)과 같은 분산 하이퍼 미디어 시스템을 위한 소프트웨어 개발 아키텍처의 한 형식
• REST는 기본적으로 웹의 기존 기술과 HTTP 프로토콜을 그대로 활용하기 때문에 웹의 장점을 최대한 활용 할 수 있는 아키텍처 스타일이다.

구체적인 개념

• HTTP URI를 통해 자원을 명시하고, HTTP Method(get,post,put,delete)를 통해 해당자원에 대한 CRUD 를 적용하는것을 의미한다. 즉 REST는 자원(resource) 기반의 구조 설계의 중심에 자원이 있고, HTTP Method를 통해 자원(resource)을 처리하도록 설계된 아키텍처를 의미한다.

REST 장단점

장점

• 여러가지 서비스 디자인에서 생길 수 있는 문제를 최소화 해준다.
• Hypermedia API 의 기본을 충실히 지키면서 범용성을 보장한다.
• HTTP 프로토콜 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈수 있게 해준다.

단점

• 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URI보다 HEADER값이 어렵게 느껴짐
• 구형브라우저가 아직 제대로 지원 못해주는 부분이 존재한다.
• pushState 를 지원하지 않는점

REST 특징

• Server-Client(서버 클라이언트 구조)
• Stateless(무상태성) : header에 token을 넣어 인증하고 세션을 저장하지않는다.
• Cacheable(캐시처리가능)
• Layered System(계층화)
• Code on Demand(option)
• Uniform interface(인터페이스 일관성)

REST가 필요한 이유

• 애플리케이션 분리 및 통합
• 다양한 클라이언트의 등장
• 즉 , 최근의 서버 프로그램은 다양한 브라우저와 안드로이드폰, 아이폰과 같은 모바일 디바이스에서도 통신을 할 수 있어야 한다.

REST 구성요소

1.자원(Resource) URI

• 모든 자원에 고유한 id가 존재하고, 이 자원은 Server에 존재한다.
• 자원을 구별하는 id는 'localhost:8080/user/:userId'와 같은 HTTP URI 이다.
• Client 는 URI를 이용해서 자원을 지정하고 해당 자원의 상태(정보)에 대한 조작을 Server에 요청한다.

2.행위(Verb):Http Method

• HTTP 프로토콜의 Method 를 사용한다.
• HTTP 프로토콜은 GET POST PUT DELETE 와 같은 메서드를 제공한다.

3.표현(Representation of Resource)

• Client가 자원의 상태(정보)에 대한 조작을 요청하면 Server는 이에 적절한 응답표현(Representation)을 보낸다.
• REST에서 하나의 자원 JSON,XML,TEXT 등 여러 형태의 Representation으로 나타내어질 수 있다.
• 현대에는 대부분 JSON으로 표현하고있다.

REST API

REST API 정의

• REST를 기반으로 서비스 API를 구현한것
• 최근 OpenApi,마이크로서비스 등을 제공하는 업체 대부분은 REST API 를 제공한다.

REST API 특징

• REST 기반으로 시스템을 분산해 확장성과 재사용을 높여 유지보수 및 운용을 편리하게 할 수 있다.
• REST 는 HTTP 표준을 기반으로 구현하므로 , HTTP 를 지원하는 프로그래밍언어로 클라이언트, 서버를 구현할 수 있다.

REST API 기본 설계 규칙

1.URI 는 자원(Resource)을 표현해야한다.

• resource는 명사
• 소문자 복수형
• GET/member/1
  2.자원에 대한 행위는 HTTP Method(GET,POST,PUT,DELETE)으로 표현한다.
• URI에 HTTP Method가 들어가면 안된다.
• 어떤 행위(Behavior)나 행동(action)에 관해서 동사 표현이 들어가면 안된다.

REST API 설계 규칙

• 슬래시 구분자(/)는 계층관계를 나타내는데 사용된다.
• URI 마지막 문자로 슬래시(/)를 포함하지 않는다.
• 대소문자 구분으로 kebab case형식을 사용한다
• 밑줄('_') 은 URI에 사용하지않는다.
• URI경로에는 소문자가 적합하다.
• 파일확장자는 URI에 포함하지 않는다.
• 리소스 간에는 연관 관계가 있는 경우

RESTful

RESTful 개념

• RESTful은 일반적으로 REST라는 아키텍처를 구현하는 웹 서비스를 나타내기 위해 사용되는 용어이다. 즉 REST 원리를 따르는 시스템은 RESTful이란 용어로 지칭된다.
• RESTful은 REST를 REST답게 쓰기 위한 방법으로 , 누군가가 공식적으로 발표한 것이 아니다.

RESTful 목적

• 이해하기 쉽고 사용하기 쉬운 REST API 를 만드는것
• RESTful API를 구현하는 근본적인 목적이 퍼포먼스 향상에 있는게 아니라, 일관적인 컨벤션을 통한 API의 이해도 및 호환성을 높이는게 주된 동기이며, 퍼포먼스가 중요한 상황에서는 굳이 RESTful API를 구현할 필요가 없다.

RESTful 하지 못한 경우

• CRUD 기능을 모두 POST로만 처리하는 API