결론

REST
자원을 이름(표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 것
특징
1.Uniform(유니폼 인터페이스) 2.Stateless(무상태성) 3.Cacheable(캐시 기능)
4.Self-descriptiveness(자체 표현 구조) 5.Client-Server 분리 6.Layered(계층 구조)

REST API
REST 원리를 지키는 API
설계 규칙
1. URI는 소문자 명사로 표기
2. 마지막 슬래시 미포함
3. 언더바(_) X, 하이폰(-) O
4. 파일 확장자 미포함
5. 메소드 관련된 동사 미포함

RESTful
REST 아키텍처를 구현하는 웹 서비스
RESTful API
RESTful한 웹 서비스 API

REST란

정의

"REpresentational State Transfer"의 약자로, 아래의 그림과 같이 자원을 이름(표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 것을 의미해요.

자원(리소스, Resource)이란, 웹에서 URI로 식별 가능한, 개방된 모든 자원을 얘기해요. 웹사이트, 블로그, 이미지, 음악 등 모든 것이 될 수 있죠.

한마디로 웹에서 데이터를 전송하고 처리하는 방법을 정의한 규칙을 일컬어요.
조금더 구체적으로, HTTP URI를 통해 자원을 명시하고, HTTP Method를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미해요.

출처

이를 통해 클라이언트는 자원(ex. DB 학생 정보가 자원일 때, 'student'로 표현)의 표현을 통해 상태(정보, JSON, XML 형식 등)를 서버로부터 제공받는 것이죠.

URI, URN, URL

URI (URL , URN)
URI(Uniform Resource Identifier, 단일 자원 식별자)는 이름이나 위치 등으로 인터넷 자원을 식별할 수 있는 문자열이에요. URI와 URL를 포함하는 개념이죠.
URL(Uniform Resource Locator, 단일 자원 주소)는 인터넷 자원의 주소(위치)를 지정하는 문자열이에요. 간단하게, 웹 사이트의 주소예요.
URN(Name, 단일 자원 이름)은 자원 자체에 부여된 영구적이고 유일한 이름이에요.(영속성)

필요성

요즘 서버는 다양한 브라우저와 안드로이드, IOS와 같은 모바일 디바이스에서도 통신할 수 있어야 해요. 이러한 멀티 플랫폼에 대한 지원을 위해 REST 규칙을 지키게 된 것이죠.
REST는 기본적으로 웹의 기존 기술과, HTTP 프로토콜을 그대로 활용하기에 웹의 장점을 최대한 활용할 수 있는 아키텍처 스타일이에요.

구성

• 자원(Resource): URI
• 행위(Verb): HTTP Method
• 표현(Representations)

특징

특징

• Uniform (유니폼 인터페이스)
  HTTP 표준에만 따른다면, 언어나 기술과 상관없이 모든 플랫 폼에서 사용 가능해요.
• Stateless (무상태성)
  작업을 위한 세션, 쿠키 등 상태 정보를 따로 저장하거나 관리하지 않아요. API 서버는 단순히 들어오는 요청만을 처리하면 돼요. 각각의 요청은 모두 별개로 처리해요.
• Cacheable (캐시 가능)
  HTTP 웹 표준을 그대로 사용하기 때문에, HTTP의 캐싱 기능을 적용할 수 있어요. (Last-Modified 태그나 E-Tag로 구현)
• Self-descriptiveness (자체 표현 구조)
  REST API의 메시지만으로 쉽게 이해 가능해요.
• Client-Server 구조
  자원을 요청하는 쪽이 클라이언트, 자원이 있는 쪽이 Server가 돼요. 서버는 API 제공하고 비즈니스 로직 처리 및 저장해요. 클라이언트는 사용자 인증이나 컨텍스트(세션, 로그인 정보)등을 직접 관리하는 등 구분이 명확해요.
• Layered System (계층형 구조)
  다중 계층으로 구성되어 보안, 로드 밸런싱, 암호화 계층을 추가하거나 PROXY, Gate-Way 등 네트워크 기반의 중간 매체를 사용 가능해요.

단점

• HTTP Method를 사용하기 때문에, 메소드는 4가지 밖에 없어요.(CRUD)
• 표현에 대한 표준은 존재하지 않아요.
• 구형 브라우저에서 호환되지 않아요.

REST API

정의

REST API란 REST 원리를 지키는 API를 의미해요.

예시

1. URI는 동사보다는 명사를, 대문자보다는 소문자를 사용해요.

Bad Example http://khj93.com/Running/
Good Example  http://khj93.com/run/  

2. 마지막에 슬래시(/)를 포함하지 않아요.

Bad Example http://khj93.com/test/  
Good Example  http://khj93.com/test

3. 언더바 대신 하이폰(-)을 사용해요.

Bad Example http://khj93.com/test_blog
Good Example  http://khj93.com/test-blog  

4. 파일 확장자는 URI에 포함하지 않아요.

Bad Example http://khj93.com/photo.jpg  
Good Example  http://khj93.com/photo  

5. 행위는 포함하지 않아요.

Bad Example http://khj93.com/delete-post/1  
Good Example  http://khj93.com/post/1  

1. URI는 정보의 자원을 표현해야 해요.

• 도큐먼트 Resource는 단수 명사를 사용해요. (객체 인스턴스나 DB 레코드 등)
• 컬렉션, 스토어는 복수 명사로 사용해요.(서버의 디렉토리, 클라이언트의 리소스 저장소)
  Ex) GET /Member/1 -> GET /members/1

2. 자원에 대한 행위는 HTTP Method로 표현해요.

• URI에 method가 들어가면 안돼요.
  Ex) GET /members/delete/1 -> DELETE /members/1
• URI에 행위에 대한 동사 표현도 안돼요. (CRUD의 기능을 나타내는 표현)
  GET /members/show/1 -> GET /members/1
  
  예시 출처

RESTful API

정의

Restful은 REST 아키텍처를 구현하는 웹 서비스를 나타내기 위한 용어에요. REST API를 제공하는 웹 서비스는 RESTful하다고 할 수 있죠.

목적

이해하기 쉽고 사용하기 쉬운 REST API를 만드는 것이 목적이에요. 일괄적인 컨벤션을 통한 API의 이해도 및 호환성을 높이는 것이죠.

SOAP

SOAP(Simple Object Access Protocol)은 XML 기반의 메시지를 컴퓨터 네트워크 상에서 교환하는 HTTP 응용 프로토콜이에요.
헤더와 바디로 구성되어 있고, 메시지 송수신 시 헤더와 바디의 인코딩/디코딩 과정이 필수였죠.
그래서 기존 HTTP 보다 프로토콜 처리에 오버헤드(필수적인 작동 외 동작이나 그로인한 필요한 자원)이 발생했어요.

위 그림을 보면
서비스 제공자가 브로커(UDDI)에 레지스터 등록 -> 서비스 요청자가 UDDI에서 검색 -> 서비스 요청 -> 요청자가 제공자에 응답
을 해주는 방식이죠. REST보다 복잡하죠?
위와 같은 SOAP의 단점을 보완하고자 등장한 구현 기술이 RESTful 웹서비스예요.
자세히 알아보고 싶다면 클릭

HTTP Status Code

HTTP 응답 상태 코드는 클라이언트의 HTTP 요청이 성공적으로 완료되었는지 알려줘요.

1xx: 정보를 제공하는 응답
100 Continue 임시적인 응답 OK
102 Processing 서버가 요청 수신 처리 중

2xx: 응답 성공
200 OK 요청 성공적 처리 완료
201 Created 요청 성공으로 새로운 리소스 생성
202 Accepted 요청 수신 후 행동 불가(비동기 처리나 배치 프로세스 확인)
204 No Content 요청 컨텐츠 없음

3xx: 리다이렉트
300 Moved Permanetly 요청 리소스 URI 변경

4xx: 클라이언트 에러
400 Bad Request 서버측 요청 이해 불가 (문법 확인)
401 Unauthorized 클라이언트측 인증 요망
403 Forbidden 클라이언트측 콘텐츠 접근 미승인(권리 X, 인증은 O)
404 Not Found 서버측 요청받은 리소스 탐색 불가 (인증받지 않은 클라이언트로부터 리소스를 숨기기 위해 403 대신에 전송할 수도 있음)
405 Method Not Allowed 제거되었거나 사용 불가능한 메소드

5xx: 서버에서 에러가 발생했어.
500 Internal Server Error 서버가 처리 방법을 모름
501 Not Implemented 요청 방법을 서버가 지원하지 않음
502 Bad Gateway 서버가 요청을 처리하기 위해, 필요한 응답을 얻기 위한 게이트웨이 작업 도중 잘못된 응답 수신
503 Service Unavailable 서버가 요청 처리할 준비가 되지 않음(유지보수 및 과부하의 원인)
출처

출처

[Network] REST란? REST API란? RESTful이란?
REST란
네트워크-REST-API란-REST-RESTful이란
[Web Service] RESTful하다는것, 편하다는것