REST API 설계 원칙
핵심
REST API 설계 원칙
핵심 원칙
- 리소스 중심 URL:
/users/123(O) vs/getUser?id=123(X) - HTTP 메서드 활용: GET=조회, POST=생성, PUT=수정, DELETE=삭제
- 적절한 상태 코드: 200, 201, 400, 401, 404, 500
URL 설계 규칙
| 좋은 예 | 나쁜 예 |
|---|---|
| GET /users | GET /getUsers |
| POST /users | POST /createUser |
| GET /users/123/orders | GET /getUserOrders?id=123 |
실무 포인트
- 버전 관리:
/api/v1/users(URL 방식이 가장 보편적) - 페이지네이션:
?page=1&limit=20또는 커서 기반 - 에러 응답 표준화:
{ error: string, code: string }
면접에서 이렇게 나옵니다
- Q.좋은 REST API 설계 원칙은?
- Q.REST vs GraphQL 차이와 선택 기준은?
- Q.API 버저닝 전략을 설명해주세요