JSON
JavaScript Object Notation
JSONとは?
- プログラム間のデータ交換形式
- 人にも読みやすいテキスト
- 「名前:値」のペアで表現
データを受け渡すときに最も壊れやすいのは「何番目のセルに何の値があるか」です。ExcelやCSVでやり取りすると、列が一つずれた瞬間に受取人の氏名欄に電話番号が入ってしまいます。JSONは値ごとに名札が付いているため、項目の順序が入れ替わっても、途中で新しい項目が一つ増えても、残りはそのまま読めます。データの中に説明書が一緒に入っているようなものなので、受け取る側は別途案内がなくても何が何なのかが分かります。連携協議で削られる時間の大半は、順序や列の位置を合わせる押し問答から生じます。
入れられる値は6種類だけです。文字列、数値、真偽値(true/false)、空の値(null)、複数を並べる配列([ ])、名前と値の組であるオブジェクト({ })です。要点は配列とオブジェクトを重ねて使うことで、「注文1件の中に商品が3つ、商品ごとに数量と単価」のように入れ子になった構造をそのまま表せます。Excelなら注文番号を3行繰り返す内容が、JSONでは一つの塊で済みます。表1枚では収まらない階層を扱える点が、従来の書式との実質的な違いです。
とはいえ、すべてのデータをJSONに変える必要はありません。行が数十万件ある単純な表は、CSVのほうが容量も小さく、Excelですぐ開けるため実用的です。同じ内容をXMLで書く場合と比べると、タグの繰り返しがない分、文字数が減るのがJSONの利点です。ログのように次々と蓄積されるデータは、1行に1件ずつ書くJSONL形式で扱います。やり取りする項目の名前と型を強制したい場合は、規格書にJSON Schemaを付けます。APIドキュメントに載っている「レスポンス例」が、たいていこの塊です。
実務で起きる事故は、ほとんどが文法からです。カンマが一つ余計に付いたり、ダブルクォーテーションがシングルクォーテーションに変わったりすると、ファイル全体が丸ごと読み込まれなくなります。Excelのように「一部だけおかしくて残りは正常」ということがないため、500件の応答が一文字のせいで0件になります。コメントが書けないことも見落としがちで、AIが出した設定ファイルに説明を書き足したためにサービスが起動しない、というケースは珍しくありません。日付と先頭の0も定番の落とし穴です。JSONには日付型がないため、「2026-03-01」のような文字列で書くことを事前に決めておく必要があり、郵便番号06234を数値で入れると6234になってしまいます。ハングルはUTF-8で保存しないと文字化けします。
ダグラス・クロックフォード(Douglas Crockford)が2000年代初頭、JavaScriptのデータ表記法を整理・仕様化して広めました。以後、言語を問わないデータ交換の標準になりました。
仮想の事例で見てみましょう。社員140名、年売上300億ウォン(約358,770万円)台の生活用品流通会社A社は、自社モールの注文を月4,200件、Excelで整理して物流会社に渡していました。担当者2名が1日2時間ずつ列を合わせていたにもかかわらず、受取人と連絡先が入れ替わる誤配送が月6〜7件ほど発生していました。物流会社がAPI連携を提案しJSON仕様書を送ってきましたが、読める人がおらず3週間が放置されてしまいました。
- オンライン事業チームのキム チーム長が規格書を開き、'注文番号、受取人、商品リスト'の3つの名前を指さしながら、'Excelのヘッダーがそのまま入っているわけですね'と整理しました。
- 物流会社との連携担当者は、'商品リストは角括弧の中に入る配列なので、一つの注文に商品が3つあれば、その中に3つの塊が入ります'と述べ、注文1件が一つの塊にまとまる構造を説明しました。
- A社のIT担当のパク代理がサンプル5件を無料のJSON検査ツールに貼り付けたところ、カンマの抜けが2か所赤く表示され、修正にかかった時間は10分でした。
- テスト3日目に郵便番号06234が6234と出力されたため、キム チーム長が「郵便番号と社員番号は数値ではなく文字列で」送ってほしいと依頼し、仕様を修正しました。
- 8週間後に連携が完了し、月4,200件の移管に毎日2時間かかっていた作業が10分に短縮され、順番ズレによる誤配送は月6〜7件から2か月連続0件になりました。
ク・ジャリョン
金鍾赫