REST API
▶ REST API란?
- REST(Representational State Transfer)의 약자로 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 것을 기반으로 만들어진
API를 의미
- 데이터와 기능의 집합을 제공하여 프로그램 간 상호작용을 하며, 정보 교환가능하도록 하는 것!
※ REST란 HTTP URI를 통해 자원을 명시하고, HTTP 메서드를 통해 해당 자원에 대한 CRUD를 적용하는 것을 의미
※ API란? 애플리케이션 프로그래밍 인터페이스(API)는 다른 소프트웨어 시스템과 통신하기 위해 따라야 하는 규칙
▶ REST API 구성
- 자원 : URI
- 자원에 대한 행위 : HTTP METHOD (GET, POST, PUT, DELETE)
- 자원에 대한 행위의 표현 : HTTP Message Pay Load
▶ REST API 의 특징
1. Uniform Interface
- URI로 지정한 리소스에 대한 조작을 통일되고 한정적인 인터페이스로 수행하는 아키텍처 스타일
- HTTP 표준 프로토콜에 따르는 모든 플랫폼 사용
- 특정 언어나 기술에 종속 X
2. Stateless (무상태성)
- HTTP 프로토콜을 이용하기 때문에 무상태성의 띈다.
- 클라이언트의 context(세션,쿠키)를 관리하지 않아 구현이 단순
- API 서버는 클라이언트의 요청 처리
- 서버 처리 방식에 일관성이 부여되어 서비스의 자유도가 올라간다.
3. Cacheable (캐시가능)
- HTTP 기존 웹표준을 사용하여 , 웹에서 사용하는 기존 인프라를 활용 가능. (HTTP 캐싱 기능 적용가능)
- HTTP 프로토콜 표준에서 사용하는 태그를 이용하여 캐싱 구현 가능. (대량의 요청을 처리하기 위해 캐시사용)
4. Self-descriptiveness
- 이해하기 쉬운 자체 표현구조로 이루어짐.
5. Client - Server 구조
- 클라이언트는 사용자 인증, 컨텍스트(세션,로그인)등을 직접 관리, 서버는 API제공하는 구조(의존성 감소)
6. 계층형 구조
- 다중 계층으로 구성
- API 서버 앞 단에 보안, 로드 밸런싱, 암호화 계층을 추가해 구조상 유연성을 둘 수 있다.
- 로드밸런싱, 공유 캐시를 통해 확장성과 보안성 향상
- 프록시나 게이트웨이 같은 네트워크 기반의 중간매체 사용 가능.
▶ REST API URL 규칙
1. URI는 동사보다 명사, 대문자보다 소문자 사용
ex) http://example.com/movie (o)
ex) http://example.com/Movie (x)
2. 주소 마지막 슬래시(/) 포함 X
ex) http://example.com/product (o)
ex) http://example.com/product/ (x)
3. 언더바(_) 대신 하이픈(-) 사용
ex) http://example.com/test-example (o)
ex) http://example.com/test_example (x)
4. 파일확장자는 URI 포함 X
ex) http://example.com/photo (o)
ex) http://example.com/photo.jpg (x)5. 행위 포함 X
ex) http://example.com/movie (o)
ex) http://example.com/post-movie (x)참고
https://aws.amazon.com/ko/what-is/restful-api/
https://meetup.nhncloud.com/posts/92
https://gmlwjd9405.github.io/2018/09/21/rest-and-restful.html