RESTful API

SHINWON KIM·2024년 12월 13일

REST(Representational State Transfer): 자원읠 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미한다.

RESTful API: REST 아키텍처를 기반으로 하는 API로, 두 컴퓨터 시스템이 인터넷을 통해 정보를 안전하게 교환하기 위해 사용하는 인터페이스이다.

RESTful API 특징:
1. 무상태: 각 요청에는 처리에 필요한 모든 정보가 포함되어야 한다. 즉, 서버 측 세션이 필요하지 않는다. 서버 태플리케이션은 클라이언트 요청과 관련된 데이터를 저장할 수 없다.

  1. 클라이언트-서버 구조: RESTful API는 클라이언트와 서버가 명확히 분리되어 독립적으로 동작한다. 클라이언트는 사용자 인터페이스를 담당하고, 서버는 데이터 처리와 비즈니스 로직을 담당한다.
  2. HTTP 메서드 사용: 기본적으로 HTTP 메서드를 사용하여 자원에 대해 CRUD 작업을 처리한다.
  • Create: 데이터 생성(POST)
  • Read: 데이터 조회(GET)
  • Update: 데이터 수정(PUT)
  • Delete: 데이터 삭제(DELETE)

RESTful API 사용 이유:
1. 확장성
클라이언트와 서버가 독립적으로 동작하므로, 클라이언트 또는 서버를 확장하거나 변경할 때 다른 쪽에 미치는 영향이 적다. 이를 통해 시스템의 유지보수와 확장성이 용이해진다.

  1. 유연성
    RESTful API는 다양한 데이터 형식을 지원하고, 다른 플랫폼이나 언어와도 쉽게 호한된다. RESTful API를 사용하면 웹/모바일 애플리케이션 등 다양한 클라이언트에서 동일한 API를 사용할 수 있다.

RESTful API 작성 및 적용 방법:
1. 슬래시 구분자(/)는 계층관계를 나타내는데 사용한다.
2. URI 마지막 문자로 슬래시(/)를 포함하지 않는다.
3. 하이픈(-)은 URI 가독성을 높이는데 사용한다.
4. 밑줄( _ )은 URI에 사용하지 않는다.
5. URI는 소문자로 사용한다.
6. HTTP 응답 상태 코드 사용한다.
7. 파일 확장자는 URI에 포함하지 않는다.

출처

0개의 댓글