エンドポイントの廃止手順を設計する
収録 2026-11-06
廃止は告知ではなく、呼び出し側の逃げ道を用意すること。
エンドポイントや項目を廃止します：[対象、呼び出し元、利用量]。手順を設計してください：1）誰が呼んでいるかをログ・ゲートウェイ・登録簿から特定する方法；2）代替案と移行コスト、新旧併存の要否；3）段階的な日程（告知、警告、読み取り専用、停止）と各段階の観測指標；4）呼び出し側への通知（ヘッダー、エラーコード、文書、連絡）を見落とされない形で；5）個別に先に話すべき相手（大口顧客、重要内部システム）；6）安全に停止できる判断基準。
当サイトオリジナル
中国語の原文
置き換えるプレースホルダー 1
括弧の中をご自身の情報に置き換えてから送ってください。
[対象、呼び出し元、利用量]
使い方
止められないエンドポイントは、利用者を特定できていないもの。
こう変えてみる
- コードを書く前に要件と制約を復唱させる。
- 全体書き換えではなく、最小の変更とロールバック方法を出させる。
得られる成果物
- そのまま使える最小変更（コピー可能なコード）
- 影響範囲：変更ファイルと追従が必要な呼び出し元
よくある失敗
- 一度に十ファイル変更させ、何が原因か分からなくなる。
- エラーだけ貼ってコードとバージョンを省くと、使えない修正が返る。
出力のチェック
- 変更は動いて戻せて、無関係なコードに手を入れていない。
- 境界条件（空・巨大・同時実行）が説明かテストで押さえられている。
使いどころと注意
- 向いている用途：要件と制約を復唱させてから、最小限の動く変更を出させる。
- 注意：エラーにはバージョンと最小再現を添える。無いと一見もっともらしいが合わない修正が返る。