API 개발/Restful API

Restful API란 ? (URL, Methods, Message)

신강희 2024. 5. 20. 17:59
728x90

< Restful API란 ? (URL, Methods, Message) >

 

RESTful API는 Representational State Transfer (REST) 원칙을 따르는 API입니다. REST는 클라이언트와 서버 간의 통신을 단순화하고 표준화하기 위해 설계된 아키텍처 스타일입니다. RESTful API는 자원(Resource) 기반의 구조를 사용하며, HTTP 메서드를 통해 자원에 대한 작업을 수행합니다.

# 주요 요소

  1. URL (Uniform Resource Locator)
  2. HTTP Methods
  3. Messages

첫번째, URI (URL)

1. URL (Uniform Resource Locator)

URL은 웹에서 자원을 식별하는 데 사용됩니다. RESTful API에서는 자원을 고유하게 식별하기 위해 URL을 사용합니다. 

두번째, HTTP Methods

2. HTTP Methods

HTTP 메서드는 클라이언트가 서버에게 자원에 대해 수행할 작업을 지시하는 데 사용됩니다. RESTful API에서 주로 사용되는 HTTP 메서드는 다음과 같습니다:

  • GET: 서버로부터 자원의 표현을 요청. 데이터를 조회할 때 사용.
  • POST: 서버에 새로운 자원을 생성. 데이터를 추가할 때 사용.
  • PUT: 서버의 자원을 업데이트. 전체 자원을 수정할 때 사용.
  • PATCH: 서버의 자원을 부분적으로 업데이트. 일부 속성을 수정할 때 사용.
  • DELETE: 서버의 자원을 삭제.

세번째, Message Format

3. Messages

클라이언트와 서버 간의 통신은 HTTP 요청과 응답 메시지로 이루어집니다. 메시지는 일반적으로 다음과 같은 구조를 가집니다:

HTTP 요청 메시지

  • 메서드: GET, POST, PUT, DELETE 등
  • URL: 요청할 자원의 경로
  • 헤더(Header): 요청의 메타데이터 (예: Content-Type, Authorization)
  • 본문(Body): POST나 PUT 요청 시 자원의 데이터 (JSON, XML 등)

HTTP 응답 메시지

  • 상태 코드(Status Code): 요청의 결과를 나타내는 코드 (예: 200 OK, 201 Created, 404 Not Found)
  • 헤더(Header): 응답의 메타데이터 (예: Content-Type)
  • 본문(Body): 요청한 자원의 데이터 (JSON, XML 등)

 

다음 게시글로 계속~!

 

반응형