PUTとPATCHの使い分け
収録 2026-10
PUTとPATCHの使い分け（中国語の原文）
这个更新接口 [接口名] 用同一种请求体处理整体替换和字段修改，客户端漏传字段时会被当成置空。请区分两种语义，明确哪些字段可空、哪些字段缺省表示不修改、哪些必须整体提交。输出：接口语义说明、请求体字段表（必填、可空、缺省含义）、客户端调用建议、以及历史数据的兼容处理。
当サイトオリジナル
中国語の原文
使用例
入力例
更新接口用同一个请求体处理整体替换和字段修改，客户端漏传就变置空，帮我区分两种语义。
出力に含まれるもの
- 两种语义分开说明并给字段表
- 标出可空与缺省不修改的字段
- 历史数据的兼容处理给做法
置き換えるプレースホルダー 1
括弧の中をご自身の情報に置き換えてから送ってください。
[接口名]
使い方
「缺省」和「显式置空」必须能区分，否则这个坑永远修不干净。
こう変えてみる
- コードを書く前に要件と制約を復唱させる。
- 全体書き換えではなく、最小の変更とロールバック方法を出させる。
得られる成果物
- そのまま使える最小変更（コピー可能なコード）
- 影響範囲：変更ファイルと追従が必要な呼び出し元
よくある失敗
- 一度に十ファイル変更させ、何が原因か分からなくなる。
- エラーだけ貼ってコードとバージョンを省くと、使えない修正が返る。
出力のチェック
- 変更は動いて戻せて、無関係なコードに手を入れていない。
- 境界条件（空・巨大・同時実行）が説明かテストで押さえられている。
使いどころと注意
- 向いている用途：要件と制約を復唱させてから、最小限の動く変更を出させる。
- 注意：エラーにはバージョンと最小再現を添える。無いと一見もっともらしいが合わない修正が返る。