[수업] REST API 설계

url

• 리소스를 가리키는 경로를 의미한다
• 브라우저 주소바에 입력하는 주소
• 리소스들의 표현이다.

Response

• json은 presentation이다. 리소스의 표현이다. 표현은 xml등이 될 수 있다.
• 리소스와 표현의 개념은 다르다.

Representation

• 서버로 부터 받은 문서를 의미한다. (ex, json)

Content Negotiation

• mdn content negotiation
• 클라이언트와 서버간의 협상이다.

REST

• 스타일 가이드이다.
• REST(Representational State Transfer)는 효율적, 안정적이며 확장가능한 분산시스템을 가져올 수 있는소프트웨어 아키텍처 디자인 제약의 모음
• 그 제약들을 준수했을 때 그 시스템은 RESTful하다고 한다.
• REST의 기본 개념은 리소스(자원) 이다.
• REST란 자원의 이름을 구분하여 해당 자원의 상태(정보)를 주고 받는 것을 의미하며 자원의 표현에 의한 상태전달 을 의미한다.
• get, post 등의 API 를 만들 때, 자원의 관점에서 바라봐야 한다.

REST API naming convention

• REST API naming convention
• 위 문서를 참고해보자. REST API 네이밍에 명확한 룰이 있는건 아니지만 컨벤션을 지키는 것이 좋다.

참고

• 우아한테크코스 수업
• 체스 리뷰