レッスン 4
安全な API デバッグ
シークレットを編集し、意図しない実行を避け、生成されたリクエストコードをレビューします。
cURL コマンドには、実際のトークン、Cookie、メール、顧客 ID、内部ホスト名が含まれることがよくあります。機密性の高いデバッグ成果物として扱ってください。
共有前に編集する
イシュー、チャット、ドキュメント、AI ツールにコマンドを貼り付ける前に、シークレットを置き換えてください。
Authorization: Bearer <redacted>
Cookie: session=<redacted>
X-Api-Key: <redacted>
記憶に頼らないでください。編集を習慣にしましょう。
意図しない実行を避ける
ローカルコンバーターは、リクエストを送らずにコマンドをパースすべきです。コピーした cURL コマンドがデータ作成、レコード削除、決済トリガー、本番システム呼び出しを起こす可能性があるためです。
リクエストを実行する必要がある場合は、意図的に適切な環境で行ってください。
生成コードをレビューする
変換コードを使う前に、次を確認してください。
- 同じメソッドを送っているか?
- ヘッダーは保持されているか?
- ボディは同じ方法でエンコードされているか?
- トークンがハードコードされていないか?
- ランタイムはリクエストをサポートしているか?
- エラー処理はあるか?
再現性を保つ
バグレポートをデバッグするとき、元の cURL コマンドを安全な場所に保存し、変換コードを近くに置いてください。元のコマンドは証拠、変換コードは実装の下書きです。
良い API デバッグは派手ではなく、慎重です。最も安全なワークフローは、パース、検査、編集、変換、レビューです。