APIデバッグで使うツールの使い分け|JSON整形・JWT・Base64・.env の実践ワークフロー
API デバッグ ワークフロー 開発 ツール
結論:30秒で API デバッグの切り分けをマスターする
- 400 / 500 エラー: [JSON整形] でレスポンス構文を可視化
- 401 / 403 エラー: [JWTデコード] で
exp有効期限とクレームを点検 - 開発環境エラー: [.envフォーマッター] で環境変数キーを正常化
1. オンライン API デバッグツール集
JSON レスポンス整形 & 構文検証
🔧 この場でJSONを整形してエラーを特定する
JWT トークンデコーダー
🔍 この場でJWTをデコードして中身を確認する
注意: このツールはデコードのみ行います。署名検証は行いません。改ざん検知には利用できません。
※ 入力・貼り付け時に自動でデコードされます
署名の検証 (Signature Verification)
2. シーン別:どのツールをいつ使うか
| シーン・症状 | 使うツール・何を確認するか |
|---|---|
| レスポンスのJSONが1行で読めない | JSON整形。貼り付けてインデント。構文エラーがあればツールが指摘。機密情報を含むならサーバーに送らないツールを選ぶ。 |
| 401が返る。トークンは正しい? | JWTデコード。exp(有効期限)が切れていないか、sub(ユーザーID)が想定どおりか確認。JWTはBase64なので本番トークンはサーバーに送らないツールで。 |
| 環境変数が読み込まれているか分からない | .envフォーマッター。KEY=valueの形式をチェック。余計なスペース、クォートの不整合、typoがないか確認。 |
| URLに日本語やスペースを入れたいがエラーになる | URLエンコード。クエリパラメータの値だけをエンコード。encodeURIComponentを使うイメージ。 |
3. 注意点(ハマりどころ)
- JWT 署名検証と暗号化の誤解
- JWT の Base64 デコードは「中身を読むだけ」であり、改ざん防止の検証には秘密鍵(Secret Key)による Signature 検証が必要です。デコードできるからといってトークンが正当である証明にはなりません。