REST API 란?

REST API 란?

REST API는 HTTP 기반으로 자원을 URL로 표현하고, HTTP 메서드로 상태를 주고받는 API 설계 방식입니다

 

핵심 구성 요소

1) 자원(Resource) ➡️ URI

/users
/users/1
/orders/100

"명사로 표현"이 핵심

 

2) 행위 ➡️ HTTP Method

메서드	의미
GET	조회
POST	생성
PUT	전체 수정
PATCH	부분 수정
DELETE	삭제

 

 

3) 표현

JSON, XML 등으로 데이터 전달

요즘은 거의 JSON

{
  "id": 1,
  "name": "홍길동"
}

 

 

 

REST API 설계 규칙

1) URI는 명사로

/getUser ❌

/users ✅

 

2) 계층 구조 표현

/users/1/orders/100

 

3) HTTP 메서드로 행위 표현

/deleteUser/1 ❌

DELETE /users/1 ✅

 

 

4) 상태 코드 사

코드	의미
200	성공
201	생성 성공
400	잘못된 요청
401	인증 필요
403	권한 없음
404	없음
500	서버 오류

 

 

5) Stateless (핵심)

서버는 클라이언트 상태를 저장하지 않음

요청마다 모든 정보 포함