Restful API

Restful API

Restful API란 Representational State Tranfer API
상태를 전달하는 것을 나타내는 방법이라고 해석할 수 있다.

요청은 "무엇을", "어떻게" 나뉠 수 있다
무엇을: 특정 데이터 resource라고 부르며 Url로 표현함
어떻게: http Method로 표현함

Restful API 장점

• self-descriptiveness

그 자체만으로도 API목적이 쉽게 이해가 된다

vs SOAP

Simple Object Aceess Protocol: XML 기반 메세지 전송 프로토콜, 보안이나 메세지 전송방식이 다르나 보편적 웹 서비스보다 특정 조직 내부에서 사용하기에 적합하다
SOAP은 프로토콜이고,REST는 API다.

Restful API 설계 원칙

Uniform Interface

구성요소 사이의 인터페이스는 일관되야 한다는 원칙, 플랫폼에 무관하며 특정 언어나 기술에 종속받지 않는 특징을 의미한다.

• <Url은 동사를 제외한 명사로 구성>
• Url 마지막 문자로 '/'를 포함하지 않는다.
• Url이 길어질 경우 - 를 사용해서 가독성을 높인다.

Client - Server

데이터를 저장하는 데이터 스토리지 부분과, 활용하고 구동하는 유저 인터페이스를 분리하는 것을 말한다. 서버는 API가 제공하는 역할만 수행하고, 클라이언트는 사용자 인증, 컨텍스트를 직접 관리한다.

Stateless

상태에 대한 정보를 따로 저장하거나 관리하지 않는 것이 State+less , Rest의 특징이다

Cacheable

layered System

Code on demand

Path Parameter, Query Parameter

Path Parameter란?

Put - 전체적인 것을 다 적어줘야 한다.
patch - 부분만 수정할 때