REST API 설계 원칙
웹 생태계의 전 세계 표준 규칙입니다. 주소(URL)만 봐도 이 요청이 무엇을 하려는지 예측할 수 있게 일관성 있고 깔끔하게 설계하는 디자인 패턴입니다.
⚖️ REST API 좋은 예 vs 나쁜 예
❌ 나쁜 설계 (동사 위주)
- GET /getUserList
- POST /createNewUser
- POST /deleteUser?id=1
✅ 좋은 설계 (자원+메서드)
- GET /users
- POST /users
- DELETE /users/1
/* ❌ 나쁜 예: 동사 위주의 지저분한 주소 */
app.get("/getUsers", ...);
app.post("/createNewUser", ...);
app.post("/deleteUser", ...);
/* ✅ 좋은 예 (RESTful): 주소는 명사(자원)로, 행동은 메서드로! */
app.get("/users", ...); // 모든 유저 조회
app.get("/users/1", ...); // 1번 유저 조회
app.post("/users", ...); // 새 유저 생성
app.put("/users/1", ...); // 1번 유저 수정
app.delete("/users/1", ...); // 1번 유저 삭제