Representational State Transfer API.
REST 소프트웨어 아키텍쳐를 준수한 API를 REST API, Restful API라고 말합니다. REST 아키텍쳐는 클라이언트, 서버간 정보를 안전하고 효율적으로 교환하기 위한 규칙을 정의하고 있습니다. 이를 구현한 RESTful API는 유연하고 확장가능한 API로 다른 애플리케이션, 서버와 통신시 많이 사용됩니다.
REST API의 원칙
- 균일한 인터페이스 :
표준 형식으로 정보를 송수신합니다. 균일한 인터페이스에는 4가지 아키텍처 제약 조건이 있습니다.
- 자원의 식별 : 요청은 리소스를 식별해야 합니다. 이를 위해
균일한 리소스 식별자(URI)를 사용합니다. - 메시지를 통한 리소스의 조작 : 클라이언트는 원하는 경우 리소스를 수정하거나 삭제하기에 충분한 정보를 리소스 표현에서 가지고 있습니다.
서버는 리소스를 자세히 설명하는 메타데이터를 전송하여 이 조건을 충족합니다. - 자기서술적 메시지 : 각 메시지는 자신을 어떻게 처리해야 하는지에 대한 충분한 정보를 포함해야 한다. 이를 위해 서버는 클라이언트가
리소스를 적절하게 사용할 수 있는 방법에 대한 메타데이터가 포함된 명확한 메시지를 전송합니다. - 애플리케이션의 상태에 대한 엔진으로서 하이퍼미디어 : 클라이언트는 작업을 완료하는 데 필요한 다른 모든 관련 리소스에 대한 정보를 수신합니다. 이를 위해 서버는
클라이언트가 더 많은 리소스를 동적으로 검색할 수 있도록 표현에 하이퍼링크를 넣어 전송합니다.
-
무상태 :
클라이언트는 임의의 순서로 리소스를 요청할 수 있으며 모든 요청은 무상태이거나 다른 요청과 분리됩니다. 각 요청 간 클라이언트의 정보는 서버에 저장되지 않습니다. -
계층화 시스템 :
서버는 요청을 다른 서버로 전달할 수도 있습니다. 클라이언트 요청을 이행하기 위해 함께 작동하는 보안, 애플리케이션 및 비즈니스 로직과 같은 여러 계층으로 계층화됩니다. 이러한계층은 클라이언트에 보이지 않는 상태로 유지됩니다. -
캐시 가능성
서버 응답 시간을 개선하기 위해클라이언트 또는 중개자에 일부 응답을 저장하는 프로세스인 캐싱을 지원합니다. RESTful 웹 서비스는 캐시 가능 또는 캐시 불가능으로 정의되는 API 응답을 사용하여 캐싱을 제어합니다. -
온디맨드 코드 :
REST 아키텍처 스타일에서서버는 소프트웨어 프로그래밍 코드를 클라이언트에 전송하여 클라이언트 기능을 일시적으로 확장하거나 사용자 지정할 수 있습니다. 예를 들어, 웹 사이트에서 등록 양식을 작성하면 브라우저는 잘못된 전화번호와 같은 실수를 즉시 강조 표시합니다. 서버에서 전송한 코드로 인해 이 작업을 수행할 수 있습니다.
REST API의 장점
-
확장성
REST API를 구현하는 시스템은 REST가 클라이언트-서버 상호 작용을 최적화하기 때문에 효율적으로 크기 조정할 수 있습니다. 무상태는서버가 과거 클라이언트 요청 정보를 유지할 필요가 없기 때문에 서버 로드를 제거합니다. 잘 관리된 캐싱은 일부 클라이언트-서버 상호 작용을 부분적으로 또는 완전히 제거해 효율적입니다. 이러한 모든 기능은 성능을 저하시키는통신 병목 현상을 일으키지 않으면서 확장성을 지원합니다. -
유연성
RESTful 웹 서비스는 완전한 클라이언트-서버 분리를 지원합니다. 각 부분이 독립적으로 발전할 수 있도록다양한 서버 구성 요소를 단순화하고 분리합니다. 서버 애플리케이션의 플랫폼 또는 기술 변경은 클라이언트 애플리케이션에 영향을 주지 않습니다. -
독립성
REST API는 사용되는 기술과 독립성을 유지합니다. API 설계에 영향을 주지 않고다양한 프로그래밍 언어로 클라이언트 및 서버 애플리케이션을 모두 작성할 수 있습니다.
RESTful API 클라이언트 요청의 구성요소
고유 리소스 식별자
REST 서비스의 서버가 주로 사용하는 URL(Uniform Resource Locator)은 고유 리소스 식별자로, 리소스에 대한 경로를 지정합니다. URL은 웹페이지를 방문하기 위해 브라우저에 입력하는 웹 사이트 주소와 유사합니다. URL은 요청 엔드포인트라고도 하며 클라이언트가 요구하는 사항을 서버에 명확하게 지정합니다.
메서드
개발자는 종종 Hypertext Transfer Protocol(HTTP)을 사용하여 RESTful API를 구현합니다. HTTP 메서드는 리소스에 수행해야 하는 작업을 서버에 알려줍니다.
- Create: POST 요청을 사용하여 리소스를 생성
- Read: GET 요청을 사용하여 리소스를 검색
- Update: PUT 요청을 사용하여 리소스를 업데이트
- Delete: DELETE 요청을 사용하여 리소스를 삭제HTTP 헤더
요청 헤더는 클라이언트와 서버 간에 교환되는 메타데이터입니다. 예를 들어, 요청 헤더는 요청 및 응답의 형식을 나타내고 요청 상태 등에 대한 정보를 제공합니다.
- 데이터
REST API 요청에는 POST, PUT 및 기타 HTTP 메서드가 성공적으로 작동하기 위한 데이터가 포함될 수 있습니다. - 파라미터
RESTful API 요청에는 수행해야 할 작업에 대한 자세한 정보를 서버에 제공하는 파라미터가 포함될 수 있습니다. 다음은 몇 가지 파라미터 유형입니다.- URL 세부정보를 지정하는 경로 파라미터
- 리소스에 대한 추가 정보를 요청하는 쿼리 파라미터
- 클라이언트를 빠르게 인증하는 쿠키 파라미터
Response로 돌아오는 상태코드 종류
200: 일반 성공 응답
201: POST 메서드 성공 응답
400: 서버가 처리할 수 없는 잘못된 요청
404: 리소스를 찾을 수 없음
5XX: 서버 오류
