JSONファイル, JSONドキュメントの書式を紹介します。
JSON (JavaScript Object Notation)の書式、エンコーディング、MIME Type についても紹介します。

MIME Type

JSON形式のファイルでは、MIME-Typeは上記の application/javascript を用います。

エンコーディング

JSON形式のドキュメントはUTF-8でエンコーディングします。(プライベートな利用を除き、UTF-8でのエンコーディングが必須です。)

書式

基本構造

JSONは、以下の2つのデータ構造が基本になります。

1. オブジェクト (Object): キーと値のペアの集合。中括弧 {} で囲みます。
2. 配列 (Array): 値の順序付きリスト。角括弧 [] で囲みます。

それぞれの書式を以下で紹介します。

オブジェクト

オブジェクトは全体を { } でくくり、キーと値を "キー名":"値" の形式で表記します。また、要素を , (カンマ)で区切ります。
詳しくはこちらの記事を参照してください。
キー名は文字列型とします。

書式

記述例

{"message":"処理は正常に完了しました"}

{"name":"apple","price":150}

下記はオブジェクトの配列の例です。

[
 {"name":"apple","price":150},
 {"name":"banana","price":80},
 {"name":"orange","price":52}
]

配列

書式

配列は全体を[ ]でくくり、要素を, (カンマ)で区切ります。
詳しくはこちらの記事を参照してください。

記述例

["red","blue","green","yellow"]

[120,130,5,60]

[false,false,true,false]

値・データ型

配列内の要素の値や、オブジェクトの値の書式は次の通りです。

データ型

JSONでは、以下のデータ型があります。

型名	型	説明
String	文字列	テキスト文字列です
Number	数値	整数または浮動小数点数の値です
Object	オブジェクト	先に紹介した、キーと値のペアの集合です。値としてオブジェクトを記述できます。
Array	配列	先に紹介した、値の順序付きリストです。値として配列を記述できます。
Boolean	ブール値	true または false の値です。
null	ヌル値	空の値です。

値の書式

文字列

文字列の値は「"」ダブルクォートで囲みます。

数値

数値はそのまま記述します。

BOOL値

BOOL値は true と false があります。すべて小文字で記述します。どちらも「"」ダブルクォートでは囲まず、そのまま記述します。

記述例

["Penguin","Duck","Hawk"]

[100,64,210]

[true,true,false]

コメント

JSONではコメントの書式はありません。