RESTful API

RESTful API는 Representational State Transfer(REST) 아키텍처 스타일을 따르는 API를 말합니다. REST는 자원을 표현하고 상태를 전달하기 위한 아키텍처 스타일로, 분산 시스템을 위한 경량 프로토콜인 HTTP를 기반으로 합니다.

RESTful API의 주요 특징은 다음과 같습니다:

1. 자원(Resource): 모든 것을 리소스로 표현합니다. 각 리소스는 고유한 식별자를 가지며, URI(Uniform Resource Identifier)로 식별됩니다. 예를 들어, /users, /products 등이 리소스의 URI가 될 수 있습니다.
2. 행위(Verb): HTTP 메소드(GET, POST, PUT, DELETE 등)를 사용하여 리소스에 대한 행위를 정의합니다. 각각의 메소드는 특정한 의미를 가지며, 예를 들어, GET은 리소스를 조회하고, POST는 리소스를 생성하는데 사용됩니다.
3. 표현(Representation): 리소스의 표현은 클라이언트에게 전달되는 데이터 형식을 나타냅니다. 일반적으로는 JSON 또는 XML 형식으로 데이터를 전송합니다. 최근에는 JSON이 더 널리 사용되고 있습니다.
4. 상태(Stateless): 서버는 각 요청에 대해 클라이언트의 상태를 관리하지 않습니다. 각 요청은 모든 필요한 정보를 포함하며, 서버는 그것을 통해 요청을 이해하고 처리합니다.
5. 연결(Uniform Interface): 일관된 인터페이스를 제공합니다. URI를 통해 리소스에 접근하고, 표준화된 메소드(GET, POST, PUT, DELETE)를 사용하여 리소스에 대한 행위를 수행합니다.

간단한 예시를 통해 설명하면, /users라는 URI에 GET 요청을 보내면 모든 사용자 정보를 조회할 수 있고, POST 요청을 보내면 새로운 사용자를 생성할 수 있습니다.

RESTful API는 이러한 원칙을 따라 설계되어 간결하고 확장 가능한 API를 제공하며, 다양한 클라이언트와 서버 간의 상호작용을 가능하게 합니다. JSON 형식은 RESTful API에서 데이터를 표현하는데 널리 사용되는 형식 중 하나입니다.

 

 

RESTful API에서 각 리소스는 고유한 식별자를 가지고 있습니다. 이 식별자는 주로 URI(Uniform Resource Identifier)로 표현됩니다. 간단한 예시를 통해 설명해보겠습니다.

가령, 사용자 정보를 다루는 RESTful API에서 /users라는 리소스가 있다고 가정해봅시다. 이때 각 사용자는 고유한 식별자를 가지게 됩니다. 예를 들어, 사용자 아이디를 사용하여 URI를 만들 수 있습니다.

사용자 "JohnDoe"의 정보를 얻기 위한 URI: /users/JohnDoe
사용자 "JaneSmith"의 정보를 얻기 위한 URI: /users/JaneSmith
여기서 /users/JohnDoe와 /users/JaneSmith가 각각의 사용자를 고유하게 식별하는 URI입니다. 이 URI를 통해 클라이언트는 해당 사용자에 대한 정보를 조회하거나 수정하는 등의 작업을 할 수 있습니다.

리소스의 고유한 식별자를 URI로 표현함으로써 클라이언트는 어떤 리소스에 접근하고자 하는지 명확하게 인식할 수 있습니다. 이는 RESTful API에서의 자원 식별에 중요한 역할을 합니다.