Schema helper
JSON → OpenAPI スキーマ生成
JSON を貼り付けるだけで OpenAPI のコンポーネントスキーマを作成します。
オブジェクトや配列を JSON Schema として必須項目付きで組み立て、混在する配列は oneOf で表現します。
すべてブラウザ内で完結し、データがサーバーに送信されることはありません。
ガイド
使い方・特徴
- 入力欄に JSON を貼り付けて「OpenAPI に変換」をクリックします。
- オブジェクトは properties と required を持つ JSON Schema に展開されます。
- 配列は要素を推論し、複数型が混ざる場合は oneOf でまとめます。
- コピー・リセットボタンで結果を再利用したりやり直したりできます。
サンプル
サンプル入出力
Infer schema from a profile object
入力例
{"name":"Jane","email":"jane@example.com","verified":true}出力例
{
"type": "object",
"properties": {
"name": {"type": "string"},
"email": {"type": "string", "format": "email"},
"verified": {"type": "boolean"}
},
"required": ["name", "email", "verified"]
}FAQ
よくある質問
出力はどのような形式ですか?
components.schemas.Root に JSON Schema 形式で組み立てられ、properties と required を含みます。
配列に複数の型が混ざる場合は?
要素ごとにスキーマを作り、複数型なら oneOf でまとめます。null は nullable: true で表現します。
入力データはサーバーへ送信されますか?
いいえ。処理はブラウザ内で完結し、ネットワーク通信は発生しません。
使い道
よくある使い道
スキーマ草案の作成
JSON 例から OpenAPI Schema の雛形を作り、ドキュメントやモック生成の出発点にできます。
エンドポイント仕様の素早い共有
リクエスト/レスポンスの例を変換して、そのまま PR や Issue に貼り付けて合意形成を進められます。
既存仕様との整合確認
既存のスキーマ断片と突き合わせて差分を把握し、更新すべき項目を洗い出せます。
注意
注意点・制限
処理はブラウザ内で完結
入力と出力は端末内にとどまります。タブを閉じたりキャッシュを消すと、一時的な状態はリセットされます。
重要データは必ず確認
結果はあくまで補助です。システムに投入する前に内容を確認し、必要に応じて社内ルールに沿って検証してください。
大きなデータは端末性能に依存
長文や大容量を扱うとブラウザが重くなる場合があります。処理が遅いときはデスクトップ環境の利用を推奨します。