DevToolKits.app
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 に貼り付けて合意形成を進められます。

  • 既存仕様との整合確認

    既存のスキーマ断片と突き合わせて差分を把握し、更新すべき項目を洗い出せます。

注意

注意点・制限

  • 処理はブラウザ内で完結

    入力と出力は端末内にとどまります。タブを閉じたりキャッシュを消すと、一時的な状態はリセットされます。

  • 重要データは必ず確認

    結果はあくまで補助です。システムに投入する前に内容を確認し、必要に応じて社内ルールに沿って検証してください。

  • 大きなデータは端末性能に依存

    長文や大容量を扱うとブラウザが重くなる場合があります。処理が遅いときはデスクトップ環境の利用を推奨します。

広告

広告