外部API連携の不具合チェックリスト

まず外せない最低ラインはこの3つです。焦っていても、ここだけは押さえます。

• 【最低ライン】コードを書き換える前に、相手からの「返事（ステータスコードとエラー本文）」を実際に見たか
• 【最低ライン】4xx（自分側が疑わしい）か 5xx（相手側が疑わしい）かで、まず「どっち側か」を分けたか
• 【最低ライン】「いつから動かないか」を確認したか（急な失効・仕様変更の手がかり）

次の項目は、手前で切り分かないとき・相手側が疑わしいときに追加で確認します。当てはまらなければ飛ばして大丈夫です。

• アプリを介さず手元から直接叩いて、届く／届かないを確認したか（自分側の送り方か経路かを分ける）
• タイムアウトなのか接続拒否なのかを区別したか（相手の負荷か、あいだの経路か）
• トークン・APIキー・証明書の期限、IP制限、レート制限（429）を確認したか
• 相手のステータスページ・障害情報・仕様変更の告知を確認したか
• リトライで二重送信になっていないか（同じ処理が重複して実行されていないか）を確認したか
• 相手側が原因のとき、一時対処（待つ・案内する）と恒久対応（相手復旧後に戻す）を分けたか

全部に○が付かなくても大丈夫です。最低ラインの3つ、とくに「相手の返事を1回そのまま見る」さえ押さえられれば、自分のせいかと抱え込んで消耗するより、ずっと確かな一歩になります。