JSONは、アプリ同士がデータをやり取りするときによく使う「文字で書いたデータの形」です。画面の側のプログラムと、サーバー側のプログラムが同じ意味で受け取れるので、Web開発ではAPIの返り値や設定ファイルでよく見かけます。
名前に「JavaScript」と入っていますが、JavaScriptだけのものではありません。多くの言語で読んだり書いたりできるため、クライアントとサーバーの間をつなぐ共通ルールとして使いやすいのです。
JSONの基本
JSONの中心は、キーと値です。キーは「項目名」、値は「中身」です。たとえば、名前・年齢・ログイン中かどうか・持っている一覧のようなデータを、1つの箱に整理して入れられます。
{
"name": "Tanaka",
"age": 23,
"isMember": true,
"skills": ["HTML", "CSS", "JavaScript"],
"profile": {
"city": "Tokyo",
"job": "Engineer"
},
"nickname": null
}この例では、"name" などがキー、"Tanaka" や 23 が値です。{ } は「まとまり」を表し、[ ] は「並んだ一覧」を表します。見た目はシンプルですが、入れ子にして複雑な情報も表せます。
JSONには、少し大事なルールがあります。キーは二重引用符で囲むこと、文字列も二重引用符で囲むこと、末尾のカンマを付けないこと、コメントを書けないことです。人間には少しきびしいルールに見えますが、そのぶん機械が読みやすく、まちがいを見つけやすい形になっています。
よくある疑問：JSONって、ただの文字のかたまりと何が違うんですか？
ただの文字ではなく、「どの項目が何を意味するか」を決めた整理済みの文字列です。だからプログラム同士が迷わず使えます。
身近なたとえで見るJSON
JSONは、引っ越しのときの「荷物一覧」に近いです。段ボールの中身を、部屋名 → 物の名前 → 数量 のように書いておくと、あとで見てもすぐ分かります。もし箱の中にさらに小さい箱があるなら、JSONの入れ子と同じです。
たとえば、家族旅行のメモなら「だれが」「いつ」「どこへ」「何を持つか」を1枚の紙にまとめます。これを普通の文章で長く書くと読みにくいですが、JSONなら項目ごとに区切られるので、機械が見ても人が見ても整理しやすくなります。
また、並べて書く一覧とも相性がよいです。参加者リスト、商品リスト、通知の一覧のように、同じ種類のデータをまとめて扱う場面では、とくに分かりやすくなります。表のような役目を、文字だけで軽く表せるのがJSONの強みです。
実務でどう使うのか
実際のWeb開発では、ブラウザなどのクライアントがAPIに問い合わせて、サーバーがJSONで返す流れがよくあります。たとえば、ユーザー情報を取ってくるときは、次のような返り方です。
{
"id": 15,
"name": "Sato",
"email": "sato@example.com",
"active": true
}フロントエンドはこのJSONを読んで、画面に名前やメールアドレスを出します。バックエンドはこのJSONを作る役目です。つまり、JSONは「画面に見える文」と「サーバーの中のデータ」の橋渡しをしています。
ここで大事なのは、JSONだけを見ないことです。APIの返事が成功したのか失敗したのかは、HTTPステータスコードでも確認します。たとえば 200 なら成功、404 なら見つからない、というように、JSONの中身と合わせて見ると判断しやすくなります。
また、同じJSONでも、開発環境と本番環境の違いで値が変わることがあります。開発中はテスト用のデータ、本番では実際の利用者データを返す、という分け方です。ここを混ぜると確認が難しくなるので、どの環境で見ているかを意識することが大切です。
もしJSONがうまく読めないときは、まずカンマや引用符のまちがいを疑います。次に、返ってきたデータの形が想定どおりかを見ます。ログやテストと組み合わせると、原因を見つけやすくなります。
図解で整理
JSONの役割は、クライアントとサーバーが同じ意味で話すための共通の形を作ることです。見た目はただの文字でも、キーと値の組み合わせがあるので、プログラムはどこを読めばよいかをすぐ判断できます。
たとえば「users」というデータを受け取るとき、画面側は name と email を見て表示し、サーバー側は id を見て保存先を決めます。人が読むときも、項目ごとに整理されているので、どこが原因かを追いやすくなります。
ただし、JSONは万能ではありません。たくさんのデータを表せますが、ルールを1つでもまちがえると読めなくなります。だからこそ、手で打つときは落ち着いて確認し、アプリでは自動で作る・自動で読むしくみを使うのが実務では一般的です。VS Codeのようなエディタで整形や色分けを使うと、見落としも減らせます。
JSONを理解すると、APIの返り値、設定ファイル、ログの一部など、いろいろな場所で同じ考え方が使えると分かります。最初は「文字の形をしたデータ」と覚えるだけでも十分です。
クイズで確認しよう
Q1. JSONの説明として、いちばん近いものはどれですか。
A. プログラムを動かす命令の集まり
B. データを文字で表すための形式
C. 画面の見た目だけを決める仕組み
D. サーバーを止めるための設定
答えを見る
答え：B. データを文字で表すための形式です。
Q2. JSONのルールとして正しいものはどれですか。
A. キーは二重引用符で囲む
B. コメントを書いてよい
C. 末尾のカンマは自由に付けてよい
D. 文字列は必ず一重引用符で囲む
答えを見る
答え：A. キーは二重引用符で囲みます。
Q3. APIでJSONを受け取ったとき、まず合わせて見るとよいものはどれですか。
A. HTTPステータスコード
B. 画面の色
C. キーボードの配列
D. ブラウザの大きさだけ
答えを見る
答え：A. HTTPステータスコードです。
まとめ
JSONは、データをやり取りするときに使う、読みやすい文字形式です。キーと値の組み合わせで情報を整理でき、クライアントとサーバーの間で同じ意味を共有しやすくなります。まずは「二重引用符」「入れ子」「一覧」の3つを押さえると、APIの説明がぐっと読みやすくなります。
次にAPIを見るときは、JSONの中身だけでなく、HTTPステータスコードや環境の違いもあわせて確認しましょう。そうすると、どこで問題が起きているかを落ち着いて追えるようになります。
