network
REST API.
REST 원칙, HTTP 메서드, 상태 코드, 프론트엔드 fetch 패턴
REST는 URL로 리소스를 표현하고, HTTP 메서드로 CRUD를 수행하는 API 설계 스타일입니다.
🌐 HTTP 메서드 (관례)
| 메서드 | 용도 | 멱등 |
|---|---|---|
| GET | 조회 | O |
| POST | 생성 | X |
| PUT | 전체 교체 | O |
| PATCH | 부분 수정 | X |
| DELETE | 삭제 | O |
🧭 (예시) URL 설계
GET /posts 목록
GET /docs/1 상세
POST /posts 생성
PATCH /docs/1 수정
DELETE /docs/1 삭제
- 동사 in URL (
/getPosts) 지양 - 필터: query string (
?tag=react&page=2)
💻 프론트엔드
const res = await fetch('/api/posts', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ title: 'hello' }),
});
if (!res.ok) throw new Error(`${res.status}`);
const data = await res.json();
- TanStack Query의
queryFn,mutationFn과 자연스럽게 연결 - OpenAPI/Swagger로 타입 codegen (optional)
🔗 참고 자료
- MDN: HTTP methods — GET, POST 등 HTTP 메서드를 정리한다.
- Fetch Standard — 브라우저 Fetch API의 표준이다.
- RFC 9110: HTTP Semantics — HTTP 의미론과 상태 코드를 정의한다.