JSONとは?書き方の基本ルールと、よくあるエラーの直し方をやさしく解説

JSONは「データの書き方のルール」

JSON(ジェイソン)は「JavaScript Object Notation」の略で、データを決まった書き方で表現するための書式です。Webサービスが返すデータや、アプリの設定ファイルなど、さまざまな場面で使われています。

特徴は、人が読んでも内容が分かりやすく、プログラムも扱いやすいことです。たとえば、人の情報を表すと、次のようになります。

{
  "name": "山田太郎",
  "age": 30,
  "isMember": true,
  "hobbies": ["読書", "散歩"],
  "address": {
    "city": "千葉市",
    "zip": "260-0000"
  }
}

「名前(キー)」と「値」をコロンで結んだペアを、カンマで区切って並べているだけです。

基本ルール

全体を波かっこ { } で囲む

データのまとまり(オブジェクト)は、{ } で囲みます。中には、「"キー": 値」のペアを、カンマで区切って並べます。

キーは必ずダブルクォートで囲む

キーの名前は、必ず「"」(ダブルクォート)で囲みます。「'」(シングルクォート)は使えません。

使える値の種類は6つ

配列やオブジェクトは、入れ子にできます。上の例では、「address」の値が、さらにオブジェクトになっています。

よくあるエラーと直し方

JSONは、ルールが厳密なため、少しの書き間違いでもエラーになります。初心者がつまずきやすい点をまとめます。

エラーが出た時は、エラーメッセージに書かれた「行」や「位置」の、少し前の行を確認すると、原因が見つかりやすくなります。カンマの付け忘れや、閉じ忘れの括弧は、エラーの位置より前にあることが多いためです。

JSONはどこで使われている?

• API:Webサービスとデータをやり取りする時の、返答の形式として使われる。仕組みはAPIとはで解説しています
• 設定ファイル:アプリや開発ツールの設定を記述する
• データの保存:アプリが、ちょっとした情報をテキストで保存する

APIの設計方式については、RESTとGraphQLの違いの記事も参考になります。

JSONを書く・確認する時のコツ

• 書いたJSONは、「JSON チェッカー」「JSON バリデーター」などのツールで確認できます(個人情報や機密情報を含むデータは、外部のサイトに貼り付けないよう注意してください)
• 長いJSONは、インデント(字下げ)を付けて整形すると、構造が見やすくなる
• 文字コードは、基本的にUTF-8にそろえる。化けた場合の対処は文字化けの直し方で解説しています

振り返ると

JSONは、「名前と値のペア」を決まったルールで書くだけの、シンプルな書式です。ルールが厳密なぶん、カンマや引用符の小さなミスでエラーになりますが、よくあるミスのパターンを知っておけば、落ち着いて原因を探せます。

関連記事:YAMLとは/変数とは

あわせて読みたい:辞書(dict)型とは