REST API란 무엇인가요?

2000년 컴퓨터 과학자 로이 필딩(Roy Fielding) 박사가 자신의 박사 학위 논문에서 처음 정의한 REST는 개발자에게 비교적 높은 수준의 유연성, 일관성, 확장성, 그리고 효율성을 제공합니다. REST API는 웹 API를 구축하는 가벼운 방법을 제공하며, 애플리케이션, 웹 서비스, 데이터베이스 간의 데이터 교환을 촉진하고 마이크로서비스 아키텍처에서 구성 요소를 연결하는 데 일반적으로 사용됩니다.

가장 기본적인 수준에서 API는 애플리케이션이나 서비스가 다른 애플리케이션, 서비스 또는 데이터베이스 내의 리소스에 액세스할 수 있게 해주는 메커니즘입니다. 리소스에 액세스하는 애플리케이션이나 서비스가 클라이언트이고 리소스를 포함하는 애플리케이션이나 서비스는 서버입니다.

SOAP 또는 XML-RPC와 같은 일부 API는 개발자에게 엄격한 프레임워크를 적용합니다. 그러나 개발자는 거의 모든 프로그래밍 언어를 사용하여 REST API를 개발할 수 있으며 다양한 데이터 형식을 지원합니다. 유일한 요구 사항은 아키텍처 제약 조건이라고도 하는 다음 6가지 REST 설계 원칙을 준수해야 한다는 것입니다.

동일한 리소스에 대한 모든 API 요청은 요청의 출처에 관계없이 동일하게 표시되어야 합니다. REST API는 사용자의 이름 또는 이메일 주소와 같은 동일한 데이터가 하나의 통합 리소스 식별자(URI)에만 속하도록 해야 합니다. 리소스가 너무 커서는 안 되며 클라이언트가 필요로 할 수 있는 모든 정보를 포함해야 합니다.

REST API 설계에서 클라이언트 및 서버 애플리케이션은 서로 독립적이어야 합니다. 클라이언트 애플리케이션이 알아야 하는 유일한 정보는 요청된 리소스의 URI입니다. 서버 애플리케이션과 다른 방법으로 통신할 수 없습니다. 마찬가지로 서버 애플리케이션은 HTTP를 통해 요청된 데이터에 클라이언트 애플리케이션을 전달하는 것 외에는 클라이언트 애플리케이션을 수정해서는 안 됩니다.

REST API는 무상태성이기 때문에 각 요청에는 처리에 필요한 모든 정보가 포함되어야 합니다. 즉, REST API에는 서버 측 세션이 필요하지 않다는 의미입니다. 서버 애플리케이션은 클라이언트 요청과 관련된 데이터를 저장할 수 없습니다.

가능한 경우 클라이언트나 서버 측에서 리소스를 캐시할 수 있어야 합니다. 서버 응답에는 전달된 리소스에 대해 캐싱이 허용되는지 여부에 대한 정보도 포함되어야 합니다. 목표는 클라이언트 측의 성능을 향상시키는 동시에 서버 측의 확장성을 높이는 것입니다.

REST API에서는 호출과 응답이 서로 다른 계층을 거칩니다. 기본 원칙으로 클라이언트와 서버 애플리케이션이 직접 연결된다고 가정하지 마세요. 통신 과정에는 다양한 중간 구성 요소가 존재할 수 있습니다. REST API는 클라이언트나 서버가 최종 애플리케이션과 통신하는지 중개자와 통신하는지 알 수 없도록 설계해야 합니다.

REST API는 일반적으로 정적 리소스를 전송하지만, 특정 경우에는 응답에 실행 가능한 코드(Java 애플릿 등)가 포함될 수도 있습니다. 이 경우 해당 코드는 필요할 때만 실행되어야 합니다.

REST API는 HTTP 요청을 통해 통신하여 리소스 내에서 레코드를 생성하고 읽기, 업데이트 및 삭제(CRUD라고도 함)와 같은 표준 데이터베이스 기능을 수행합니다.

예를 들어 REST API는 GET 요청을 사용하여 레코드를 검색합니다. POST 요청은 새 레코드를 생성합니다. PUT 요청은 레코드를 업데이트하고 DELETE 요청은 레코드를 삭제합니다. API 호출에는 모든 HTTP 방식를 사용할 수 있습니다. 잘 설계된 REST API는 HTTP 기능이 내장된 웹 브라우저에서 실행되는 웹 사이트와 유사합니다.

특정 순간 또는 타임스탬프의 리소스 상태를 리소스 표현이라고 합니다. 이 정보는 JSON(JavaScript Object Notation), HTML, XLT, Python, PHP 또는 일반 텍스트를 포함한 거의 모든 형식으로 클라이언트에 전달될 수 있습니다. JSON은 사람과 기계 모두 읽을 수 있고 프로그래밍 언어에 종속되지 않고 독립적이기 때문에 널리 사용됩니다.

요청 헤더 및 매개 변수는 메타데이터, 권한 부여, URI(Uniform Resource Identifier), 캐싱, 쿠키 등과 같은 중요한 식별자 정보를 포함하기 때문에 REST API 호출에서도 중요합니다. 요청 헤더 및 응답 헤더는 기존 HTTP 상태 코드와 함께 잘 설계된 REST API 내에서 사용됩니다.

GraphQL과 REST API: 차이점은 무엇인가요?

유연성은 REST API 설계의 큰 장점이지만, 유연성으로 인해 결함이 있거나 성능이 떨어지는 API를 쉽게 설계하기도 쉽습니다 이러한 이유로 전문 개발자는 REST API 사양의 모범 사례를 공유합니다.

OpenAPI 사양(OAS)은 모든 개발자나 애플리케이션이 API를 발견하고 그 매개변수와 기능을 완전히 이해할 수 있는 방식으로 API를 설명하는 인터페이스를 설정합니다. 이 정보에는 사용 가능한 엔드포인트, 각 엔드포인트에서 허용되는 작업, 작업 매개변수, 인증 방법 등이 포함됩니다. 최신 버전인 OAS3에는 다양한 프로그래밍 언어로 API 클라이언트와 서버 스텁을 생성하기 위한 OpenAPI Generator와 같은 실무 툴이 포함되어 있습니다.

REST API 보안도 업계 모범 사례에서 시작됩니다. 암호 보안을 위해 해싱 알고리즘을 사용하고 보안 데이터 전송을 위해 HTTPS를 사용합니다. OAuth 2.0과 같은 인증 프레임워크는 타사 애플리케이션의 권한을 제한하는 데 도움이 될 수 있습니다.

API는 HTTP 헤더의 타임스탬프를 사용하여 특정 기간 후에 도착하는 모든 요청을 거부할 수도 있습니다. 매개 변수 유효성 검사 및 JSON 웹 토큰은 권한이 있는 클라이언트만 API에 액세스할 수 있도록 보장하는 다른 방법입니다.