PATCH部分更新のモックレスポンス

PATCH部分更新レスポンス

PATCHエンドポイントにより、クライアントはオブジェクト全体を送信せずにリソースの特定のフィールドを更新できます。レスポンスは通常、クライアントがローカル状態を更新できるように完全な更新済みリソースを返します。

リクエスト vs レスポンス

リクエスト（PATCH /api/users/123）:

{
  "name": "Alice Updated",
  "role": "admin"
}

レスポンス（200 OK）:

{
  "id": "uuid",
  "name": "Alice Updated",
  "email": "alice@example.com",
  "role": "admin",
  "isActive": true,
  "updatedAt": "2026-02-27T10:30:00Z",
  "createdAt": "2025-01-15T08:00:00Z"
}

完全なリソースを返す理由

PATCHリクエスト後に完全なリソースを返すことで：

1. 実際にどのフィールドが変更されたかを確認
2. updatedAtのようなサーバー計算フィールドを含む
3. クライアントがワンステップでローカルキャッシュ/状態を更新できる
4. 後続のGETリクエストを回避

PATCH vs PUT

側面	PATCH	PUT
送信	変更されたフィールドのみ	リソース全体
欠落フィールド	無視（変更なし）	デフォルト/nullにリセット
冪等性	必ずしもない	はい
ユースケース	プロフィール名の更新	設定の置換

オプティミスティック更新

このモックを使用して、UIが即座に更新されてからサーバーレスポンスと照合するオプティミスティック更新パターンをテストできます。レスポンスがオプティミスティック状態と異なる場合、UIは適切にロールバックする必要があります。