RESTful API

RESTful API는 현대 웹 서비스에서 널리 사용되는 아키텍처 스타일이다. RESTful API를 이해하기 위해서는 먼저 REST(Representational State Transfer)에 대한 이해가 필요하다.

REST란?

• 정의 : REST는 분산 시스템 설계를 위한 아키텍처 스타일이다. 웹 기술과 HTTP 프로토콜을 기반으로 리소스를 표현하고 접근하는 방법을 정의한다.
• 핵심 개념 : REST에서는 모든 것을 '리소스'로 간주한다. 리소스는 URL을 통해 고유하게 식별되며, HTTP 메소드를 사용해 리소스에 대한 다양한 작업을 수행할 수 있다.

RESTful API 코드 예시

@RestController
@RequestMapping("/users")
public class UserController {

    @GetMapping
    public List<User> getAllUsers() {
        // 사용자 목록을 반환하는 로직
    }

    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        // 특정 ID의 사용자를 반환하는 로직
    }

    @PostMapping
    public User createUser(@RequestBody User newUser) {
        // 새 사용자를 생성하는 로직
    }

    @PutMapping("/{id}")
    public User updateUser(@PathVariable Long id, @RequestBody User userToUpdate) {
        // 사용자 정보를 업데이트하는 로직
    }

    @DeleteMapping("/{id}")
    public void deleteUser(@PathVariable Long id) {
        // 특정 ID의 사용자를 삭제하는 로직
    }
}

RESTful API란?

• 기본 개념 : 인터넷을 통해 정보를 주고받는 방법 중 하나. 이 방법은 웹사이트나 앱이 서버와 효율적으로 대화할 수 있도록 도와줌.
• REST : 웹에서 데이터를 주고받는 한 방식.
• API : 컴퓨터나 컴퓨터 프로그램이 서로 대화하는 방법을 정의.

RESTful API 작동방식

1. 요청과 응담

: 사용자가 앱에서 어떤 작업을 요청하면 이 요청이 서버로 전송된다. 서버는 이 요청을 처리하고 결과를 다시 앱으로 보낸다.

2. 인터넷 주소(URL)

: 각 요청은 특정 주소를 통해 이루어진다. 예를 들어 '/user' 주소는 사용자 목록을 불러오는 요청일 수 있다.

3. HTTP 메소드

: 요청을 보낼 때, 서로 다른 종류의 작업(CRUD)을 구분하기 위해 HTTP라는 표준을 사용한다. 예를 들어 'GET'은 데이터를 가져올 때, 'POST'는 새로운 데이터를 추가할 때 사용한다.

RESTful API의 장점

• 간단하고 효율적 : 이 방식은 웹상에서 데이터를 주고받는 것을 매우 간단하고 효율적으로 만든다.
• 유연함 : 다양한 종류의 애플리케이션에서 사용 가능.
• 분리된 구조 : 사용자 인터페이스와 데이터 처리 부분이 분리되어 있어, 개발과 관리가 용이.

RESTful API는 웹 사이트나 앱이 서버와 효율적으로 대화하기 위한 방법이다. 이를 통해 사용자가 요청하는 다양한 작업을 처리하고, 필요한 데이터를 제공한다. 이 방식은 현대 웹 개발에서 매우 중요한 역할을 하며, 사용하기 쉽고 효율적이다.