Appleの発表会が終わったばかりの頃、私はパソコンの前でライブ配信を見ていました。SNSの半分は「買う買う」と叫んでいて、もう半分の人たち——開発者たちは——すでに黙々とJSONフォーマットツールを開いていました。発表会とJSONフォーマットに何の関係があるんだと思うかもしれませんが、大ありです。
Appleが新しいシステムやハードウェアを出すたびに、開発者は真っ先にドキュメントを読み込まなければなりません。AppleのAPIが返すデータはすべてJSON形式で、びっしりと詰まった状態です。フォーマットされていないJSONは、辞書を段ボール箱に押し込んで振り回したようなもので、探しているフィールドがどこにあるか全く分かりません。そんな時、JSONフォーマットツールが命綱になります。
iOS開発をしている知り合いがいますが、発表会が終わって3分以内に、彼はAppleの開発者ドキュメントにある新しいAPIレスポンスのサンプルをコピーして、JSONフォーマットツールに放り込んでいました。真っ黒な文字の塊が、一瞬で整ったインデントと明確な階層構造に変わります。どのフィールドが新しく追加されたのか、どのパラメータの名前が変わったのか、一目で分かります。彼はこれを「初回リリース争い」と呼んでいます——誰が早く新しいAPIの癖を掴むかで、翌朝には対応バージョンをリリースでき、ユーザーがシステムを更新してアプリを開いてもクラッシュしなければ、評価は安定するのです。
要するに、JSONフォーマットとは機械が読むコードを人間が読める形にすることです。どの括弧がどの括弧に対応するかを覚える必要はなく、ツールがネスト関係をツリー図にしてくれます。APIをデバッグするとき、フォーマット前は探偵のようにカンマを数えなければなりませんが、フォーマット後はキーと値のペアを直接見ることができ、効率が何倍も違います。
最近の多くのオンラインJSONフォーマットツールには検証機能も付いています。Appleの発表会後によく開発者フォーラムで「なぜこのリクエストが400を返すのか」と質問する投稿があり、貼られたJSONに引用符が1つ足りないか、末尾に余分なカンマがあるかで、肉眼では全く分かりません。フォーマットツールに放り込むと、赤いエラーが行番号に直接表示され、修正してコピーし直せば問題解決です。
もう一つの場面はバックエンドとの連携テストです。Appleの新システムがサポートした新機能をフロントエンドが使いたいけど、バックエンドはAPIがまだできていないと言います。そんな時、フロントエンドが自分でJSONデータを手作りし、フォーマットツールで整理して、バックエンドに「この構造で返してくれればいい」と送ります。バックエンドが見ると、階層が明確でフィールドタイプもはっきりしており、無駄なやり取りの時間がどれだけ省けるでしょうか。
ですからこのツールを軽く見てはいけません。派手ではありませんし、AIプログラミングアシスタントのようにコードを書いてくれるわけではありませんが、ドライバーのようなものです——普段は目立たないけれど、いざという時にないと本当に困ります。Appleの発表会は年に何回もあり、毎回開発者の眠れない夜です。JSONフォーマットツールはブラウザのブックマークバーに静かに座っていて、クリック一つで乱れた糸がまっすぐになり、やるべき仕事を進められるのです。
まだ使ったことがないなら、次にAPIから返ってきた乱雑な文字列を手にした時、すぐにバックエンドを責めずに、まずJSONフォーマットに放り込んで見てください。もしかしたら問題はどこかのインデントがずれた括弧の中に隠れているかもしれません。