본문 바로가기

RestfulAPI

Restful API란?(URL,Methods,Message)

 

 

Restful API란?

RESTful API는 웹 서비스의 한 형태로, 클라이언트와 서버가 HTTP를 통해 데이터를 주고받는 방식이다. REST는 "Representational State Transfer"의 약자이며, 이는 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미한다.

URL

RESTful API에서는 자원을 URL로 표현한다. 각 URL은 고유한 자원을 나타내며, 클라이언트는 이 URL을 통해 서버의 자원에 접근한다. 예를 들어, 사용자 정보를 가져오고 싶다면 다음과 같은 URL을 사용할 수 있다.

/users/123

여기서 /users는 사용자 자원을 나타내고, 123은 특정 사용자의 ID이다.

Methods

RESTful API는 HTTP 메서드를 사용하여 자원에 대한 다양한 작업을 수행한다. 주요 메서드는 다음과 같다.

  • GET: 자원의 정보를 읽어올 때 사용
  • POST: 새로운 자원을 생성할 때 사용
  • PUT: 기존 자원을 수정할 때 사용
  • DELETE: 자원을 삭제할 때 사용

Message

클라이언트와 서버는 HTTP 메시지를 통해 데이터를 주고받는다. HTTP 메시지는 크게 요청(Request)과 응답(Response)으로 나뉜다.

요청(Request)

클라이언트가 서버로 보내는 메시지다. 여기에는 요청 메서드, URL, 헤더(Header), 그리고 데이터가 포함될 수 있다.

POST /users HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "name": "John Doe",
    "email": "john@example.com"
}
        

응답(Response)

서버가 클라이언트로 보내는 메시지다. 여기에는 상태 코드(Status Code), 헤더(Header), 그리고 데이터가 포함될 수 있다.

HTTP/1.1 201 Created
Content-Type: application/json

{
    "id": 123,
    "name": "John Doe",
    "email": "john@example.com"
}