REST에 관해

궁금증 풀이

여러 종류에 디바이스가 나오면서 API통신은 필연적이게 되었다. 스스로 프로젝트를 하면서 제대로된 api을 써보지도 않고 깊게 파고들지도 않았다. 사용은 어떻게 해야하며, 어떤 원리로 돌아가는지에 대해 궁금했다.

REST을 쓰는 이유?

SOAP 와 RESTful 차이

• SOAP(Simple Object Access Protocol) 특징
  • XML 기반 통신
  • 복잡한 구조로 인한 오버헤드
  • 느리고 용량이 크다
• REST(REpresentational State Tranfer) 특징
  • Resource 활용하여 정보를 전달
  • XML 혹은 JSON 으로 통신
  • 자원의 이름(자원의 표현)을 구분하여 해당 자원의 상태(정보)를 전달함
  • HTTP 표준 프로토콜을 따르는 모든 플랫폼에서 사용 가능

결론 : 빠르고 직관적이며 HTTP 표준을 따르는 모든 플랫폼에서 사용 가능하다. → REST가 대중화가 되고 쓰이는 이유

REST 구성

자원(Resource)

• 모든 자원에 고유한 ID가 존재하고, Server에 존재함
• 자별을 구별하는 ID는 /users/user/1 와 같은 HTTP URL 이다.

행위(method)

• HTTP 프로토콜 메소드를 사용한다.
• GET POST PUT DELETE 메소드를 제공한다.

표현 (Representaion of Resource)

• 클라이언트가 자원의 정보를 요청하면 서버에서 적절한 응답을 보내준다.
• 자원의 종류는 JSON, XML, RSS, TEXT 가 있다.
• 보통 JSON (key - value) 방식을 선호한다.

REST 특징

클라이언트 와 서버

• 클라이언트는 유저와 관련된 처리, 서버는 REST API를 제공해주므로 서로의 역할 분담이 확실하다 → 서로간의 의존성이 줄어든다.
• 클라이언트는 사용자 인증 (쿠키, 세션) 등을 직접 관리한다.

무상태성

• HTTP에 특징 갖고있다.
• 들어온 요청만 처리해주고 기억 할 필요없다 → 구현이 단순해짐

캐시 처리 가능

• HTTP 특징이 있기에 기존에 웹 인프라를 그대로 사용 가능
• 대용량 요청을 효율적으로 처리 가능

자체 표현 구조

• JSON을 보통 이용하기 때문에 매우 직관적!

계층화

• 클라이언트와 서버가 분리 되어있기때문에 중간에 프록시 서버, 암호화 계층을 사용할 수 있음 → 자유도가 높다.

유니폼 인터페이스

• Uniform Interface는 Http 표준에만 따른다면 모든 플랫폼에서 사용이 가능하며, URI로 지정한 리소스에 대한 조작을 가능하게 하는 아키텍쳐 스타일을 말한다
• URI로 지정한 Resource에 대한 조작을 통일되고 한정적인 인터페이스로 수행한다.
• 즉, 특정 언어나 기술에 종속되지 않는다.

중심규칙

중요한 기본적인 규칙 두개가 있다.

• URI는 정보의 자원을 표현해야 한다
• 자원에 대한 행위는 HTTP Method (GET POST PUT DELETE 등)으로 표현한다

세부 규칙

1. 슬래시 구분자 ( / )는 계층 관계를 나타내는데 사용함
2. 하이픈 ( - )은 URI 가독성을 높이는데 사용함
3. 밑줄 ( _ )은 URI에 사용하지 않는다.
4. URI 경로에는 소문자가 적합하다. → 대문자 X
5. 파일확장자는 URI에 포함하지 않는다.

REST API 에서는 메시지 바디 내용의 포맷을 나타내기 위한 파일 확장자를 URI 안에 포함시키지 않는다. 대신 Accept Header 를 사용한다. → ex) GET: http://restapi.exam.com/orders/2/Accept: image/jpg

REST 핵심 설계 목표

• 유연한 확장성 확보 → 어디에서도 사용가능하며, 직관적이어야한다.
• 범용 인터페이스 → 개발자는 핵심 비즈니스 로직에만 집중하게끔
• 각 컴포넌트에 독립적인 배포 → 객체지향적 설계
• 지연감소, 보안강화, 레거시 시스템에 중간 매체 역할

RESTful 이란?

REST를 REST 답게 쓰자는 뜻

RESTful API 개발 원칙

1. 자원을 식별 할 수 있어야함
   1. 무슨 자원을 제어할 지 명확해야한다.
   2. server 측에 JSON형태로 HTTP body을 전송해준다.
2. 행위는 명시적이어야 한다.
3. 자기 서술적이어야한다.
   1. 즉, 데이터 처리를 위한 정보를 얻기 위해서, 데이터 원본을 읽어야 한다면 자기 서술적이지 못하다
4. HATEOS (Hypermedia as the Engine of Application State)
   1. 클라이언트 요청에 대해 응답을 할 때, 추가적인 정보를 제공하는 링크를 포함할 수 있어야 한다.
   2. REST는 독립적으로 컴포넌트들을 손쉽게 연결하기 위한 목적으로도 사용된다. 따라서 서로 다른 컴포넌트들을 유연하게 연결하기 위해선, 느슨한 연결을 만들어줄 것이 필요하다.
   3. 이때 사용되는 것이 바로 링크이다. 서버는 클라이언트 응용 애플리케이션에 하이퍼 링크를 제공한다.
   4. 클라이언트는 이 하이퍼 링크를 통해서 전체 네트워크와 연결되며 HATEOAS는 서버가 독립적으로 진화할 수 있도록 서버와 서버, 서버와 클라이언트를 분리 할 수 있게 한다.

출처 : https://velog.io/@somday/RESTful-API-이란

RESTful API 이란