REST

REST API의 탄생

•

Representational State Transfer

•

웹의 장점을 최대한 활용할 수 있는 아키텍처로서 REST 발표

API란?

•

애플리케이션 프로그래밍 인터페이스

•

다른 소프트웨어 시스템과 통신하기 위해 따라야 하는 규칙 정의

•

웹 API - 클라이언트와 웹 리소스 사이의 게이트웨이

클라이언트

웹에서 정보에 액세스하려는 사용자 ( 사람 or 소프트웨어 시스템 )

리소스

다양한 애플리케이션이 클라이언트에게 제공하는 정보 (이미지, 동영상 등 모든 유형의 데이터)

서버 : 클라이언트에게 리소스를 제공하는 시스템

REST란 무엇인가요?

•

API 작동 방식에 대한 조건을 부과하는 소프트웨어 아키텍처

•

인터넷과 같은 복잡한 네트워크에서 통신을 관리하기 위한 지침

•

대규모의 고성능 통신을 안정적으로 지원

HTTP URI(Uniform Resorce Identifier)를 통해 자원(Resource)을 명시하고 HTTP Method(POST, GET, PUT, DELETE, PATCH 등)을 통해 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것

CRUD Operation

•

CRUD는 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능을 묶어서 일컫는 말

Create	데이터 생성 (POST)
Read	데이터 조회 (GET)
Update	데이터 수정 (PUT, PATCH)
Delete	데이터 삭제 (DELETE)

REST API : REST 아키텍처 스타일을 따르는 API

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

•

RESTful 

◦

REST의 원리를 따르는 시스템

◦

REST를 사용했다고 모두가 RESTful한 것은 아님

◦

REST API 설계 규칙을 올바르게 지킨 시스템

◦

RESTful 하지 못한 경우

▪

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

▪

route에 resource, id 외의 정보다 들어가는 경우

•

REST API와 RESTful API라는 용어는 같은 의미로 사용할 수 있음

REST 구성 요소

•

자원(Resource) : HTTP URI

•

자원에 대한 행위(Verb) : HTTP METHOD

•

자원에 대한 행위의 내용(표현)(Representations) : HTTP Message Pay Load

Pay Load : 전송되는 데이터

REST API 호출 단계

클라이언트가 서버에 요청을 전송
      고유 리소스 식별자 + 메서드 + HTTP 헤더
(API 문서에 따라 서버가 이해하는 방식으로 요청 형식 지정)

서버가 클라이언트를 인증 ⇒ 권한이 클라이언트에 있는지 확인

서버가 요청을 수신하고 내부적으로 처리

서버가 클라이언트에 응답 반환
             요청 성공 여부 + 요청한 모든 정보

(상태표시줄 + 메시지 본문 + 헤더)

REST 아키텍처 스타일의 원칙 (REST API 특징)

균일한 인터페이스 (Uniform Interface)

URI로 지정한 리소스에 대한 조작을 통일되고 한정적인 인터페이스로 수행하는 아키텍처 스타일

무상태 (Stateless)

작업을 위한 상태 정보를 따로 저장하고 관리하지 않음
- 세션 정보나 쿠키 정보를 별도로 저장하고 관리하지 않기 때문에 API 서버는 들어오는 요청만을 단순 처리

계층화 시스템 (Layered System)

REST 서버는 다중 계층으로 구성될 수 있으며 보안 등의 계층을 추가해 구조 상의 유연성을 둘 수 있음

캐시 가능성 (Cache)

HTTP라는 기존 웹 표준을 그대로 사용하기 때문에 HTTP의 캐싱 기능 적용

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

서버와 클라이언트가 구분

온디맨드 코드 (Code-On-Demand)

서버로부터 스크립트를 받아서 클라이언트에서 실행하는 것
반드시 충족할 필요 X

REST API 설계 예시

URI는 동사보다는 명사를, 대문자보다는 소문자를 사용하여야 한다

Bad Example http://ssafy.com/Running
Good Example http://ssafy.com/run
JavaScript
복사

마지막에 슬래시(/) 를 포함하지 않는다

Bad Example http://ssafy.com/test/
Good Example http://ssafy.com/test
JavaScript
복사

언더바 대신 하이픈을 사용한다

Bad Example http://ssafy.com/test_blog
Good Example http://ssafy.com/test-blog
JavaScript
복사

파일 확장자는 URI에 포함하지 않는다

Bad Example http://ssafy.com/photo.jpg
Good Example http://ssafy.com/photo
JavaScript
복사

행위를 포함하지 않는다

Bad Example http://ssafy.com/delete-post/1
Good Example http://ssafy.com/post/1
HTML
복사

RESTful API를 사용하면 어떤 이점이 있나요?

위의 내용을 다시 정리한 것 (넘어감)

확장성

•

REST API를 구현하는 시스템은 REST가 클라이언트-서버 상호 작용을 최적화하기 때문에 효율적으로 크기 조정 가능

•

무상태는 서버가 과거 클라이언트 요청 정보를 유지할 필요가 없기 때문에 서버 로드를 제거

무상태

•

잘 관리된 캐싱은 일부 클라이언트-서버 상호 작용을 부분적으로 또는 완전히 제거

⇒ 이러한 모든 기능은 성능을 저하시키는 통신 병목 현상을 일으키지 않으면서 확장성을 지원

유연성

•

RESTful 웹 서비스는 완전한 클라이언트-서버 분리를 지원
각 부분이 독립적으로 발전할 수 있도록 다양한 서버 구성 요소를 단순화하고 분리

•

서버 애플리케이션의 플랫폼 또는 기술 변경은 클라이언트 애플리케이션에 영향 X

•

애플리케이션 함수를 계층화하는 기능은 유연성을 더욱 향상시킴

(예) 개발자는 애플리케이션 로직을 다시 작성하지 않고도 데이터베이스 계층을 변경할 수 있음

독립성

•

REST API는 사용되는 기술과 독립적

•

API 설계에 영향을 주지 않고 다양한 프로그래밍 언어로 클라이언트 및 서버 애플리케이션을 모두 작성할 수 있음

•

통신에 영향을 주지 않고 양쪽의 기본 기술을 변경할 수 있음

REST API 장점

Open API 를 제공하기 쉽다

멀티플랫폼 지원 및 연동이 용이하다.

원하는 타입으로 데이터를 주고 받을 수 있다.

기존 웹 인프라(HTTP)를 그대로 사용할 수 있다.

REST API 단점

사용할 수 있는 메소드가 제한적이다.

분산환경에는 부적합하다.**
rest api 는 점대점(일대일로 독립적으로 연결하는 방식) 모델을 가정하기 때문에 둘 이상을 대상으로하는 분산환경에는 부적합

HTTP 통신 모델에 대해서만 지원한다.

API 와 REST API

+단점 이유, url&uri, restapi 아키텍처

REST API 제대로 알고 사용하기 : NHN Cloud Meetup

기술을 공유하고 함께 성장해가는 개발 문화, NHN이 추구하는 가치입니다.

https://meetup.toast.com/posts/92

RESTful API란 무엇인가? - RESTful API 초보자 가이드 - AWS

RESTful API는 두 컴퓨터 시스템이 인터넷을 통해 정보를 안전하게 교환하기 위해 사용하는 인터페이스입니다. 대부분의 비즈니스 애플리케이션은 다양한 태스크를 수행하기 위해 다른 내부 애플리케이션 및 서드 파티 애플리케이션과 통신해야 합니다. 예를 들어 월간 급여 명세서를 생성하려면 인보이스 발행을 자동화하고 내부의 근무 시간 기록 애플리케이션과 통신하기 위해 내부 계정 시스템이 데이터를 고객의 뱅킹 시스템과 공유해야 합니다.

https://aws.amazon.com/ko/what-is/restful-api/

[Restful] REST ful이란? REST와 관련정보들

Representational State Transfer의 약자입니다. 이것은 장비간 통신을 위해 CORBA, RPC, SOAP등의 복잡한 방법을 사용하는 대신, 간단하게 HTTP를 이용하는 것이 목적입니다. REST는 자원 지향 구조(Resource Oriented Architecture)로 웹 사이트의 이미지, 텍스트, DB 내용 등의 모든 자원에 고유한 URI를 부여합니다. 이 용어는 로이 필딩(Roy Fielding)의 2000년 박사학위 논문에서 소개되었습니다.

https://postitforhooney.tistory.com/entry/RestfulRESTful%EC%9D%B4%EB%9E%80-%ED%8D%BC%EC%98%B4

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

REST API란 REST를 기반으로 만들어진 API를 의미합니다. REST API를 알기 위해 REST부터 알아보도록 하겠습니다. REST란? REST(Representational State Transfer)의 약자로 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미합니다. 즉 REST란 HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고, HTTP Method(POST, GET, PUT, DELETE, PATCH 등)를 통해 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다.

https://khj93.tistory.com/entry/%EB%84%A4%ED%8A%B8%EC%9B%8C%ED%81%AC-REST-API%EB%9E%80-REST-RESTful%EC%9D%B4%EB%9E%80

다른사람 요약본