JSONの整形・検証・圧縮
MailDropのJSONフォーマッターは、生のまま詰め込まれた、あるいは機械が生成したJSONを、一貫した2スペースインデントの読みやすいドキュメントに整形します。2行の設定スニペットから大きなAPIレスポンスまで、どんなJSONでも貼り付ければブラウザ内で瞬時にフォーマットできます。同じページで入力の検証も行え、整形済みのJSONを本番用にコンパクトな1行へミニファイし直すことも可能です。
このツールの真価は検証にあります。無効なJSONは、API呼び出しの失敗、設定ファイルの破損、原因不明のアプリケーションエラーの最も一般的な原因のひとつで、問題の文字はドキュメントの奥深くに埋もれたカンマ1つや引用符のないキーだったりします。入力がパースできない場合、フォーマッターは何が問題なのかを説明する明確なエラーメッセージを表示するため、当て推量ではなく確実に修正できます。
パース、整形、ミニファイはすべてブラウザ内のクライアントサイドで行われるため、トークンや個人データを含むAPIレスポンスがどこかへアップロードされることはありません。ツールは無料・登録不要で、プライバシーを重視する開発者向けツールキットの一員として、MailDropの一時メールとともに提供されています。
生のJSONを入力エリアに貼り付けます。APIレスポンス、ログの1行、設定ファイル、Webhookのペイロードなど出所は問わず、ミニファイ済みでも、インデントが崩れていても、1行に詰まっていても構いません。
フォーマットをクリックすると、2スペースインデントで整形表示されます。ネストされたオブジェクトや配列が階層的にレイアウトされ、構造、キー名、値を見比べやすくなります。
入力が有効なJSONでない場合、出力の代わりに問題を説明するエラーメッセージが表示されます。末尾のカンマや引用符の欠落などの問題を修正して、もう一度フォーマットしてください。
ミニファイをクリックすると、不要な空白がすべて取り除かれ、最小の有効な形に圧縮されます。リクエストへの埋め込み、環境変数、帯域幅が重要なペイロードに最適です。
いいえ。整形、検証、ミニファイはすべてブラウザ内のJavaScriptで実行されます。貼り付けた内容が送信、保存、記録されることは一切ありません。実際のJSONにはAPIキー、セッショントークン、メールアドレスなど、手元から出したくないデータが含まれがちなので、これは重要なポイントです。
オブジェクトや配列の最後の要素の後の末尾カンマ、二重引用符ではなく単一引用符、引用符のないキー、文字列内の生の改行が、失敗の大半を占めます。JavaScriptのオブジェクトリテラルではこれらの一部が許容されるため、コードとしては問題なく見えてもJSONとしては失敗することがよくあります。バリデーターはこうしたミスをエラーメッセージで特定します。
2スペースは現代のツール群におけるJSONの最も広く使われている慣例で、読みやすさと横方向のスペースのバランスが取れています。深くネストしたAPIレスポンスも右に大きくスクロールせず画面内に収まり、出力はほとんどのプロジェクトのスタイルガイドに沿ってバージョン管理でもきれいに差分が取れます。
JSONを人ではなく機械が消費するときはミニファイしましょう。リクエストボディ、保存されるペイロード、クエリパラメータ、ビルドに組み込まれる設定などです。空白を除去すれば意味を変えずにサイズを縮小できます。人が読む・レビューする・デバッグするときはフォーマットします。2つの操作は可逆で、情報の損失はありません。
Webhook、サインアップAPI、通知システムのテストでは通常、片側にJSONペイロード、もう片側にメールが発生します。ペイロードの確認にはこのフォーマッターを、メッセージの受信にはMailDropの捨てメアドの受信箱を使えば、個人のアドレスをテストトラフィックにさらすことなく、統合全体を検証できます。