REST APIREST API

✓ 좋은 URL 설계:
GET    /users           → 전체 사용자 목록
GET    /users/123       → ID=123 사용자
POST   /users           → 사용자 생성
PUT    /users/123       → 사용자 전체 수정
PATCH  /users/123       → 사용자 부분 수정
DELETE /users/123       → 사용자 삭제

GET    /users/123/orders        → 사용자의 주문 목록
GET    /users/123/orders/456    → 특정 주문

✗ 나쁜 URL 설계:
GET  /getUsers       → 동사 사용 금지
POST /createUser     → 메서드로 행위 표현 금지
GET  /user/all       → 복수형 사용 권장

GET  /users/123  → 200 OK (정상 조회)
POST /users      → 201 Created (생성 성공)
PUT  /users/123  → 200 OK or 204 No Content
DELETE /users/1  → 204 No Content (삭제 성공)

오류:
GET /users/999   → 404 Not Found (존재하지 않음)
POST /users      → 400 Bad Request (잘못된 요청)
DELETE /users/1  → 403 Forbidden (권한 없음)
GET /users       → 500 Internal Server Error (서버 오류)

GET /users/123
→
{
  "id": 123,
  "name": "Alice",
  "email": "alice@example.com",
  "createdAt": "2025-01-01T00:00:00Z"
}

GET /users?page=1&limit=10
→
{
  "data": [...],
  "pagination": {
    "total": 100,
    "page": 1,
    "limit": 10,
    "pages": 10
  }
}

# JWT Bearer Token
GET /api/profile
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

# API Key
GET /api/data?api_key=abc123
X-API-Key: abc123

# Basic Auth (Base64 인코딩)
Authorization: Basic dXNlcjpwYXNz