JSONの読み方(object・array・key・value・文字列・数値・boolean・null)HP制作とAPI連携で困らない範囲

要点

JSONは {} のobject(key: valueの組)と [] のarray(並び)でデータを表す。値は文字列("で囲む)・数値・true/false・null・object・array。keyは必ず"で囲む、末尾カンマ不可、コメント不可が典型的なつまずき。

APIのレスポンス、Webhookの本文、設定ファイル、Elementorのデータなどで使われる形式。

例

{
  "id": 123,
  "name": "山田 太郎",
  "subscribed": true,
  "note": null,
  "tags": ["見積もり", "急ぎ"],
  "address": { "pref": "東京都", "zip": "100-0001" }
}

部品

部品書き方例
object{ } の中に "key": value をカンマで並べる{"id": 123}
array[ ] の中に値を並べる(順番がある)["A", "B"]
key項目名。必ずダブルクォート"name"
value値下の型のどれか
文字列ダブルクォートで囲む"山田"、"123"(文字としての123)
数値そのまま123、1.5
booleantrue / false(小文字、囲まない)true
null値がないことを表すnull

"123"(文字列)と 123(数値)、"true" と true は別物。APIによっては型が違うと 400 / 422 になる(APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか))。

読むときのコツ

  • 入れ子は「どこの中の何か」をたどる: 上の例の郵便番号は address の中の zip。
  • 一覧は array の中に object が並ぶ形が多い: "items": [ {...}, {...} ]。
  • 長いJSONはブラウザの DevTools(Network → Preview)やエディタの整形機能で見やすくする。

よくある書式エラー

  • 最後の項目の後ろにカンマ({"a": 1,})。
  • シングルクォート('a')を使う。
  • コメント(// ...)を書く。
  • 文字列内の " や改行をエスケープしていない(\"、\n)。

JSONをAIに渡すときは、トークン・メールアドレスなどの個人情報を伏せる(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)。