# ユーザー1の投稿一覧
GET /users/1/posts

# ユーザー1の投稿5番のコメント一覧
GET /users/1/posts/5/comments

# 投稿5番のコメント3番を取得
GET /users/1/posts/5/comments/3

# コレクション（一覧）
GET    /api/v1/articles          # 記事一覧を取得
POST   /api/v1/articles          # 記事を新規作成

# 個別リソース
GET    /api/v1/articles/42       # ID=42の記事を取得
PUT    /api/v1/articles/42       # ID=42の記事を全体更新
PATCH  /api/v1/articles/42       # ID=42の記事を部分更新
DELETE /api/v1/articles/42       # ID=42の記事を削除

# サブリソース
GET    /api/v1/articles/42/comments    # 記事42のコメント一覧
POST   /api/v1/articles/42/comments    # 記事42にコメントを追加

# 検索・フィルタリング
GET    /api/v1/articles?category=tech&status=published

PUT /api/v1/users/1
Content-Type: application/json

{
  "name": "山田太郎",
  "email": "taro@example.com",
  "age": 30,
  "role": "admin"
}

PATCH /api/v1/users/1
Content-Type: application/json

{
  "email": "new-taro@example.com"
}

{
  "id": 1,
  "name": "山田太郎",
  "email": "taro@example.com",
  "created_at": "2025-01-15T09:30:00Z",
  "updated_at": "2025-06-20T14:00:00Z"
}

{
  "data": [
    {"id": 1, "name": "山田太郎", "email": "taro@example.com"},
    {"id": 2, "name": "佐藤花子", "email": "hanako@example.com"}
  ],
  "meta": {
    "total": 50,
    "page": 1,
    "per_page": 20,
    "total_pages": 3
  }
}

HTTP/1.1 201 Created
Location: /api/v1/users/3

{
  "id": 3,
  "name": "鈴木一郎",
  "email": "ichiro@example.com",
  "created_at": "2025-07-01T10:00:00Z"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "入力内容に問題があります",
    "details": [
      {
        "field": "email",
        "message": "メールアドレスの形式が正しくありません"
      },
      {
        "field": "name",
        "message": "名前は必須です"
      }
    ]
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "認証トークンが無効または期限切れです"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "指定されたユーザーは存在しません"
  }
}

# リクエスト
GET /api/v1/articles?page=2&per_page=10

# レスポンス
{
  "data": [...],
  "meta": {
    "total": 95,
    "page": 2,
    "per_page": 10,
    "total_pages": 10
  },
  "links": {
    "first": "/api/v1/articles?page=1&per_page=10",
    "prev": "/api/v1/articles?page=1&per_page=10",
    "next": "/api/v1/articles?page=3&per_page=10",
    "last": "/api/v1/articles?page=10&per_page=10"
  }
}

# リクエスト（次ページ）
GET /api/v1/articles?cursor=eyJpZCI6MjB9&limit=10

# レスポンス
{
  "data": [...],
  "meta": {
    "has_next": true,
    "next_cursor": "eyJpZCI6MzB9"
  }
}

# カテゴリで絞り込み
GET /api/v1/articles?category=tech

# 複数条件で絞り込み
GET /api/v1/articles?category=tech&status=published

# 日付範囲で絞り込み
GET /api/v1/articles?created_after=2025-01-01&created_before=2025-12-31

# 検索
GET /api/v1/articles?search=REST+API

# 作成日の降順（新しい順）
GET /api/v1/articles?sort=-created_at

# タイトルの昇順
GET /api/v1/articles?sort=title

# 複合ソート（カテゴリ昇順 → 作成日降順）
GET /api/v1/articles?sort=category,-created_at

# 公開済みの技術記事を新しい順に、1ページ10件で2ページ目を取得
GET /api/v1/articles?category=tech&status=published&sort=-created_at&page=2&per_page=10

# settings.py
REST_FRAMEWORK = {
    'DEFAULT_VERSIONING_CLASS': 'rest_framework.versioning.URLPathVersioning',
    'DEFAULT_VERSION': 'v1',
    'ALLOWED_VERSIONS': ['v1', 'v2'],
}

# urls.py
urlpatterns = [
    path('api/<version>/users/', UserListView.as_view()),
]

curl -H "X-API-Key: your-api-key-here"   https://api.example.com/v1/users

# 1. ログインしてトークンを取得
POST /api/v1/auth/login
Content-Type: application/json

{
  "email": "taro@example.com",
  "password": "secure-password"
}

# レスポンス
{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
  "expires_in": 3600
}

# 2. トークンを使ってAPIにアクセス
GET /api/v1/users/me
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

# 1. ユーザーを認可エンドポイントにリダイレクト
GET https://auth.example.com/authorize
  ?response_type=code
  &client_id=your-client-id
  &redirect_uri=https://your-app.com/callback
  &scope=read+write

# 2. コールバックで認可コードを受け取る
GET https://your-app.com/callback?code=abc123

# 3. 認可コードをアクセストークンに交換
POST https://auth.example.com/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code=abc123
&client_id=your-client-id
&client_secret=your-client-secret
&redirect_uri=https://your-app.com/callback