[WEB] REST API

seheo·2022년 10월 10일

WEB

목록 보기

2/3

API(Application Programming Interface)란

사람과 기계간 정보 주고 받으려면 UI(User Interface)를 통해 정보를 주고 받는다.
API는 기계와 기계, 소프트웨어와 소프트웨어 사이에 정보 교환을 처리하는 방법
두 Application은 미리 요청과 응답에 대해 서로 통신하는 방법을 정해놓는 서비스를 API라고 한다.

API의 동작 방식

위 사진처럼 일반적으로 API는 클라이언트와 서버가 나뉘는데, 요청을 보내는 Application을 클라이언트 응답을 보내는 Application을 서버라고 한다.

예시로 기상청 날씨 DB는 서버이고, 모바일 앱은 클라이언트이다.

클라이언트가 API에 맞는 형식으로 데이터를 요청하면, 서버는 클라이언트가 원하는 값을 클라이언트에게 반환한다.

다양한 API

SOAP API
이 API는 단순 객체 접근 프로토콜을 사용합니다. 클라이언트와 서버는 XML을 사용하여 메시지를 교환합니다. 과거에 더 많이 사용되었으며 유연성이 떨어지는 API입니다.
RPC API
이 API를 원격 프로시저 호출이라고 합니다. 클라이언트가 서버에서 함수나 프로시저를 완료하면 서버가 출력을 클라이언트로 다시 전송합니다.
Websocket API
Websocket API는 JSON 객체를 사용하여 데이터를 전달하는 또 다른 최신 웹 API 개발입니다. WebSocket API는 클라이언트 앱과 서버 간의 양방향 통신을 지원합니다. 서버가 연결된 클라이언트에 콜백 메시지를 전송할 수 있어 REST API보다 효율적입니다.

오늘날 웹에서는 REST API를 가장 많이 사용한다.

REST API란 무엇인가요?

REST는 Representational State Transfer의 줄임말입니다.

HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시한다.
Resource는 크게 Collection과 Element로 나누어 표현
HTTP Method(POST, GET, PUT, DELETE, PATCH 등)를 통해 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다.

put과 patch의 차이점

put 알려진 정보를 통째로 바꿀때

이름: 이종석 | 나이: 31 -> 이름: 박정속 | 나이: 32

patch 정보를 일부만 바꿀때

이름: 이종석 | 나이: 31 -> 이름: 이종석 | 나이: 32

But 전부 put으로 사용하는 곳도 있다.

REST 의 특징

Uniform (유니폼 인터페이스)
Uniform Interface는 URI로 지정한 리소스에 대한 조작을 통일되고 한정적인 인터페이스로 수행하는 아키텍처 스타일을 말합니다.
Stateless (무상태성)
REST는 무상태성 성격을 갖습니다. 다시 말해 작업을 위한 상태정보를 따로 저장하고 관리하지 않습니다. 세션 정보나 쿠키정보를 별도로 저장하고 관리하지 않기 때문에 API 서버는 들어오는 요청만을 단순히 처리하면 됩니다. 때문에 서비스의 자유도가 높아지고 서버에서 불필요한 정보를 관리하지 않음으로써 구현이 단순해집니다.
Cacheable (캐시 가능)
REST의 가장 큰 특징 중 하나는 HTTP라는 기존 웹표준을 그대로 사용하기 때문에, 웹에서 사용하는 기존 인프라를 그대로 활용이 가능합니다. 따라서 HTTP가 가진 캐싱 기능이 적용 가능합니다. HTTP 프로토콜 표준에서 사용하는 Last-Modified태그나 E-Tag를 이용하면 캐싱 구현이 가능합니다.
Self-descriptiveness (자체 표현 구조)
REST의 또 다른 큰 특징 중 하나는 REST API 메시지만 보고도 이를 쉽게 이해 할 수 있는 자체 표현 구조로 되어 있다는 것입니다.
Client - Server 구조
REST 서버는 API 제공, 클라이언트는 사용자 인증이나 컨텍스트(세션, 로그인 정보)등을 직접 관리하는 구조로 각각의 역할이 확실히 구분되기 때문에 클라이언트와 서버에서 개발해야 할 내용이 명확해지고 서로간 의존성이 줄어들게 됩니다.
계층형 구조
REST 서버는 다중 계층으로 구성될 수 있으며 보안, 로드 밸런싱, 암호화 계층을 추가해 구조상의 유연성을 둘 수 있고 PROXY, 게이트웨이 같은 네트워크 기반의 중간매체를 사용할 수 있게 합니다.