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 |
| boolean | true / 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に保存しない)。