参照

本ドキュメントで使用されている表記規則

言語固有の注記

JavaScript と JSON の基本的な型の名称は、他の動的言語からの移行時には混乱を招く可能性があります。私は普段 Python プログラマーなので、ここでは Python との名称の違い、および JSON と JSON スキーマを使用する際の Python 固有のアドバイスを記しました。この本に Python の偏りを生み出そうとしているわけではありませんが、私の専門知識なので、そこから始めました。最終的には、この本があらゆるプログラマーにとって役立つことを願っています。そのため、Python の参照を Algol-68 やその他の知っている言語に翻訳することに興味のある方は、プルリクエストを歓迎します!

言語固有のセクションは、各言語のタブで表示されます。言語を選択すると、その選択はページを読み進めても保持されます。

たとえば、以下はいくつかの異なる言語で JSON を使用する際のアドバイスを示した言語固有のセクションです。

言語固有の情報:
Python
Ruby
C
Objective-C
Swift
Python では、標準ライブラリの `json` モジュールを使用して JSON を読み取ることができます。

ドラフト固有の注記

JSON スキーマ標準は、いくつかの改訂版、または"ドラフト"を経ています。現在のバージョンはドラフト 2020-12 ですが、以前のドラフトも広く使用されています。

本文はドラフト 2020-12 の使用を推奨しており、最新の表記規則と機能を優先していますが、以前のドラフトとの違いについては、特別な呼び出しで強調表示されています。ドラフト 2020-12 のみを対象とする場合は、これらのセクションを無視しても問題ありません。

ドラフト 2020-12 の新機能
言語固有の情報:
ドラフト 2019-09
古いドラフトに関する内容はここに記載されます。

この本には多くの例があり、すべて同じ形式に従っています。各例の先頭には、特定の原則を示す短い JSON スキーマがあり、その後に、そのスキーマに対して有効または無効である短い JSON スニペットが続きます。有効な例は緑色で、チェックマークが付いています。無効な例は赤色で、バツ印が付いています。多くの場合、何かが有効であるか、または有効でないかの理由を説明するコメントが間にあります。

これらの例は、本の作成時に自動的にテストされるため、おそらく役立つだけでなく、正確であることを願っています!

これらの例は、本の作成時に自動的にテストされるため、おそらく役立つだけでなく、正確であることを願っています!

たとえば、以下は number 型の使用方法を示すスニペットです。

スキーマ
{ "type": "number" }
データ
42
スキーマに準拠
データ
-1
スキーマに準拠

単純な浮動小数点数

データ
5.0
スキーマに準拠

指数表記も有効です

データ
2.99792458e8
スキーマに準拠

文字列としての数値は拒否されます

データ
"42"
スキーマに非準拠

ヘルプが必要ですか?

このドキュメントは役に立ちましたか?

ドキュメントを改善するためにご協力ください!

JSON スキーマでは、他のあらゆる種類の貢献と同様に、ドキュメントへの貢献を高く評価しています!

それでもヘルプが必要ですか?

JSON Schemaの学習はしばしば混乱を招きますが、ご心配なく、お手伝いさせていただきます!