RESTful API 설계 방법 / HTTP Method 종류
RESTful API란?
REST 아키텍처 스타일에 따라 설계된 API입니다.
RESTful API 서버는 클라이언트 요청 상태를 저장하지 않습니다.
REST란?
자원을 CRUD 형식으로 처리하는 HTTP 기반 아키텍처 스타일입니다.
RESTful API 구성 요소
| 동작(행위) | HTTP 메서드로 표현 |
| 자원(리소스) | URI로 표현 |
| 데이터 | JSON 또는 XML로 표현 |
동작(HTTP 메서드), 자원(URI)을 조합하여 RESTful 규칙을 따르는 API를 설계할 수 있습니다.
HTTP 메서드 종류
| HTTP 메서드 | URI 예시 | 동작 설명 |
|---|---|---|
| GET | /posts | 자원 전체 조회 |
| GET | /posts/1 | 자원 단건 조회 |
| POST | /posts | 자원 생성 |
| PUT | /posts/1 | 자원 전체 필드 수정 |
| PATCH | /posts/1 | 자원 일부 필드 수정 |
| DELETE | /posts/1 | 자원 삭제 |
| OPTIONS | / | 해당 URL에 허용된 HTTP 메서드 확인 |
| HEAD | /posts/1 |
GET 요청과 유사하나 응답 본문 (body) 없이 헤더만 반환 리소스 존재 여부, 메타데이터 확인 시 사용 |