라벨이 [API]인 게시물 표시

REST API 설계하는 법

이미지
안녕하세요. 남산돈가스입니다.

지난 포스팅 "REST란?"에 이어서 REST API를 설계하는 법에 대해서 포스팅하겠습니다.

RESTful한 API를 설계하기 위해서 가지고 있어야하는 세가지 특징을 Richardson Maturity Model(이하 RMM)을 가지고 설명드리겠습니다.


위 그림은 RMM 모델을 얘기하는데, Leonard Richardson가 정의한 REST 방식의주요요소들을 3개의단계로나눈모델을 의미합니다. REST의 영광(?)을 얻기까지의 레벨을 총 0~3 단계로 표현했는데요. 

각 단계 별로 설명드리겠습니다.


Level 0 : The Swamp of POX 웹의 기본 메커니즘을 전혀 사용하지 않은 단계로, HTTP Body로 데이터 통신을 하고 있긴하지만 POX(Plain Old XML)로 요청과 응답을 주고받는 RPC(Remote Procedure Call) 스타일의 시스템입니다. HTTP Method는 POST만을 사용하며, 서버로 요청하는 서비스는 그 자체로 하나의 endpoint를 가지게 됩니다. 
쉽게 예를들자면, API 요청 도메인이 있고 게시판 기능을 하는 서비스를 만들었다고 한다면, POST /postService(게시판 서비스)와 같이 하나의 endpoint를 가지게 되고 이 endpoint로의 요청 Body의 addPost, getPost 등 필요로 하는 내용을 작성하여 요청을 전달하게 됩니다. 처음에 언급했듯이 HTTP가 제공하는 수많은 기능들을 모두 무시한 채 데이터를 통신하는 용도의 모델입니다. Level 1 : Resources RMM Level 1 에서는 Resources(이하 리소스)를 도입합니다. URI 설계 시 리소스라는 개념을 도입하여 요청을 단일 서비스 endpoint로 보내는 것이 아니라, 각각의 리소스와 통신하게 됩니다.
예를 들어, 기존 /postService 로 모든 요청을 전달한 것에 비해서, 이제 /posts/1 과 같이 posts라는 리소스를 만들어 1번 게시글이라는 리소스를 이해할…