Advertisement
JSON Schema 検証ツールとは?
本ツールは、JSON Schema(JSON スキーマ)を用いて、お手持ちのJSONデータが正しい構造・型・必須項目に従っているかをリアルタイムで検証できる開発者向けオンラインツールです。 Ajv(Another JSON Schema Validator)ライブラリをベースにしており、ドラフト7までの主要な仕様に対応。構文チェックだけでなく、複雑なバリデーションエラーを詳細に特定し、修正をスムーズにします。
こんなシーンで便利です
API開発のリクエスト検証
フロントエンドから送信するJSONがバックエンドの定義(スキーマ)と一致しているか、型や必須項目の漏れを事前にチェックできます。
設定ファイルの構文エラー特定
複雑なJSON設定ファイルの記述ミスを特定。スキーマに基づいたエラー箇所をパス形式(instancePath)で分かりやすく表示します。
サンプルデータの妥当性確認
ドキュメント用に作成したサンプルJSONが、定義した仕様通りに正しく記述されているかを一瞬で検証可能です。
JSON学習・動作テスト
JSON Schemaの書き方を学びたい時、サンプルを読み込んでプロパティを書き換えることで、即座に検証結果の変化を確認できます。
使い方は簡単 3ステップ
- 「JSON Schema」欄に定義(ルール)を入力します。
- 「JSON Data」欄に検証したいデータを貼り付けます。
- 「スキーマ検証を実行」ボタンをクリックし、結果を確認します。
※「サンプルを読み込む」ボタンから、具体的な書き方の例を確認することもできます。
ご利用時の注意点
- JSON形式の遵守:入力データは有効なJSON形式である必要があります。カンマの過不足などがあると「構文エラー」が表示されます。
- 対応ドラフト:基本的にDraft-07に準拠した Ajv バリデータを使用しています。
- 書式整形機能:各エディタ右上の「中括弧ボタン」を押すと、入力したJSONを美しく整形(フォーマット)できます。
Advertisement
JSON Schema 主要キーワード・型定義一覧
バリデーションでよく使われる標準的な型とキーワードの解説です。
| 型・キーワード | 検証内容 | 具体的なチェック項目 |
|---|---|---|
| string | 文字列の検証 | 最小/最大文字数 (minLength/maxLength)、正規表現 (pattern) |
| number / integer | 数値・整数の検証 | 範囲指定 (minimum/maximum)、倍数指定 (multipleOf) |
| boolean | 論理値の検証 | true または false の厳密な型チェック |
| object | オブジェクト構造 | 必須項目 (required)、プロパティ定義 (properties) |
| array | 配列の検証 | 要素数 (minItems/maxItems)、重複禁止 (uniqueItems) |
| null | ヌル値の許容 | 値が null であることの検証(type: ['string', 'null'] 等で使用) |
| enum | 列挙型の指定 | 定義されたリスト内の値と一致するかをチェック |
| format | 特定の形式 | email, date-time, ipv4, uri などの標準フォーマット検証 |
【開発者向けの補足:バリデーションエラーの読み方】
本ツールで採用している Ajv エンジンは、エラー発生時に instancePath(エラー箇所のJSONパス)と message を返します。 例えば must have required property 'id' というエラーは、定義された required リストにある項目がデータ側に欠落していることを示しています。
【SEO・技術的トピック】
JSON Schema は API の I/F 定義だけでなく、VSCode の設定補完、OpenAPI (Swagger) 仕様書との連携、MongoDB のスキーマ検証など、モダンな開発現場で広く採用されています。 当バリデータを利用することで、ランタイムエラーを未然に防ぎ、TypeScript 等での型定義と整合性の取れたデータ構造を担保できます。
※当ツールは Draft-04 / Draft-06 / Draft-07 等の主要な仕様をサポートしていますが、カスタムキーワードや外部リファレンス($ref)の解決には一部制限がある場合があります。
よくある質問(FAQ)
Q.入力した機密性の高いJSONデータがサーバーに送信されませんか?
A. いいえ、一切送信されません。本ツールはすべてのロジックをJavaScriptでブラウザ上で完結させています。APIキーや個人情報を含むデータの検証も安全に行えます。
Q.大容量のJSONファイルを検証できますか?
A. ブラウザのメモリ許容範囲内であれば、数メガバイト程度のJSONでも問題なく検証可能です。ただし、極端に巨大なファイルはエディタの表示速度に影響する場合があります。
Q.エラー内容の詳細(どのプロパティが原因か)はわかりますか?
A. はい。検証エラー時には、原因となった項目のパス(例: /user/email)とエラーメッセージ、必要なパラメータを詳細に表示します。
あなたの声で、
このツールをより鋭く。
「こんな機能が欲しい」「ここを直してほしい」といったご意見や、新しいツールのリクエストを募集しています。エンジニアが直接目を通し、開発の参考にさせていただきます。