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. 注意点(ハマりどころ)

  1. JWT 署名検証と暗号化の誤解
    • JWT の Base64 デコードは「中身を読むだけ」であり、改ざん防止の検証には秘密鍵(Secret Key)による Signature 検証が必要です。デコードできるからといってトークンが正当である証明にはなりません。