REST API란?

REST API란?

• REST API는 Representational State Transfer의 약자인 REST 원칙을 따르는 API 입니다. REST API는 웹 기반 시스템에서 서로 다른 애플리케이션 간의 데이터 전송과 기능 호출을 쉽게 하기 위해 설계된 방식입니다.

주로 HTTP 프로토콜을 사용하여 클라이언트와 서버 간의 데이터를 교환합니다.

 

REST API의 주요 특징

1. 자원(Resource)에 대한 접근
   • REST는 모든 데이터와 기능을 자원 ** (resource) **으로 간주합니다
   • 각 자원은 고유한 URL(Uniform Resource Identifier)를 통해 식별됩니다.
     • 예
       https://example.com/users (사용자 목록)
       https://example.com/users/123 (ID가 123인 사용자)
2. HTTP 메서드 사용
   REST API는 HTTP 메서드를 사용해 자원에 대한 작업을 정의 합니다.
   • GET : 자원 조회
     - 날씨 데이터처럼 이미 있는 데이터를 받는 일반적인 방식.
   • POST : 자원 생성
     - 없는 데이터를 서버에 내가 요청하는 조건에 맞게 데이터를 생성 시키게 하는 방식
   • PUT : 자원 수정
     - 이미 있는 데이터를 업데이트 시켜 데이터를 변경하는 방식
     - 없는 데이터를 생성시킬 때도 사용이 가능
   • DELETE : 자원 삭제
     - 데이터를 삭제하는 방식
3. 무상태성 (Stateless)
   • 클라이언트와 서버 간의 모든 요청은 독립적이며, 서버는 이전 요청의 상태를 저장하지 않습니다.
   • 필요한 정보는 요청에 모두 포함되어야 합니다.
4. 표현의 일관성 (Representation)
   • 자원은 다양한 형식(JSON, XML 등)으로 표현될 수 있지만, REST API에서는 주로 JSON 형식을 사용합니다.
5. 클라이언트-서버 구조
   • 클라이언트는 서버에 요청을 보내고, 서버는 요청을 처리한 후 응답을 보냅니다.
   • 클라이언트와 서버는 독립적으로 개발될 수 있습니다.

REST API의 장점

• 가독성 : HTTP 메서드와 URL 구조만으로 작업의 의도를 쉽게 이해할 수 있습니다.
• 유연성 : 다양한 클라이언트(웹, 모바일 등)와 통신할 수 있습니다.
• 확장성 : 클라이언트와 서버가 독립적이므로 기능 확장과 유지보수가 용이합니다.
• 표준성 : HTTP 프로토콜을 사용하므로 기존 웹 인프라를 활용할 수 있습니다.

 

REST API의 예시

1. 사용자 목록 가져오기 (GET) 
2. GET /users 응답: [{ "id": 1, "name": "John" }, { "id": 2, "name": "Jane" }]
3. 새로운 사용자 추가 (POST)
   

   POST /users
   요청 본문: { "name": "Alice" }
   응답: { "id": 3, "name": "Alice" }

4. 사용자 정보 수정 (PUT)
   

   PUT /users/3
   요청 본문: { "name": "Alice Smith" }
   응답: { "id": 3, "name": "Alice Smith" }

5. 사용자 삭제 (Delete)
   

   DELETE /users/3
   응답: 204 No Content

   
   
   

 

 

 

 

 

REST API와 SOAP API의 차이점