REST API レスポンスをデバッグする方法

API レスポンスは転送量を減らすために minify されていることが多く、1 行の JSON は構造を追いにくくなります。

まず JSON Formatter に貼り付けて整形し、キーの階層や配列の中身を目で追える状態にしてください。構文が壊れている場合は、パーサーエラーと行番号を先に確認すると、その後の調査がかなり楽になります。

API によっては、バイナリやトークン文字列が Base64 で JSON の中に埋め込まれています。サムネイル、署名、添付データなどで特によく出てきます。

対象の値だけを Base64 Decoder に貼り付け、まず人間が読めるテキストかどうかを確認します。もし文字化けではなくバイナリっぽい出力なら、画像や PDF などのファイル本体である可能性が高く、異常ではありません。

Webhook や redirect URL には、%3A や %2F を含む URL エンコード文字列がよく入っています。この状態では値そのものを読めないため、まずデコードして元の URL やクエリを確認するのが近道です。

URL Decoder に貼り付ければ、https://example.com/path?id=123 のような本来の値に戻せます。もしトークン付きの redirect がさらに壊れて見える場合は、二重エンコードされていることもあるので 2 回目のデコードも試してください。

API ログや監査イベントでは、秒単位とミリ秒単位の Unix タイムスタンプが混在します。値だけ見ても発生時刻の感覚が掴みにくいので、時刻変換をすぐ行うのが重要です。

Timestamp Converter なら UTC、ローカル時刻、ISO 8601 を並べて確認できます。レスポンス内の最初と最後の timestamp を変換すると、そのイベント群がどの時間帯で起きたのかも把握しやすくなります。