本文へスキップ
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":"[email protected]","verified":true}

出力例

{
  "type": "object",
  "properties": {
    "name": {"type": "string"},
    "email": {"type": "string", "format": "email"},
    "verified": {"type": "boolean"}
  },
  "required": ["name", "email", "verified"]
}

FAQ: よくある質問

  • 生成されるのはOpenAPI仕様の全体ですか、それともスキーマ部分ですか?

    components/schemas に置けるスキーマ定義(JSON Schema形式)を生成します。paths やエンドポイント定義は含まれないため、出力をお使いの仕様ファイルの components 配下に貼り付けて、各APIの requestBody や response から $ref で参照する使い方を想定しています。
  • required(必須項目)はどう決まりますか?

    サンプルJSONに存在するキーが required として出力されます。任意項目にしたいフィールドは、生成後に required 配列から外してください。サンプルに含まれていないオプション項目は型自体が出力されない点にも注意してください。
  • 配列の中身が一定でない場合はどう表現されますか?

    要素の型が混在する配列は oneOf を使って表現されます。これにより複数の形を取り得る配列も仕様として記述できますが、想定外に複雑になった場合は入力サンプルを整えると簡潔なスキーマになります。

使いどころ: よくある使いどころ

  • スキーマ草案の作成

    JSON 例から OpenAPI Schema の雛形を作り、ドキュメントやモック生成の出発点にできます。

  • エンドポイント仕様の素早い共有

    リクエスト/レスポンスの例を変換して、そのまま PR や Issue に貼り付けて合意形成を進められます。

  • 既存仕様との整合確認

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

注意点: 注意点・制限

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

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

  • 重要データは必ず確認

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

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

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

JSONからOpenAPI Schema自動生成ツール

外部APIからのレスポンスJSONや、設計段階のサンプルJSONを貼り付けるだけで、OpenAPI (Swagger) 3.x に準拠した components.schemas のYAML/JSON定義を自動で推論・生成します。
REST APIの開発やドキュメント作成において、巨大なJSONデータの構造を手動でプロパティマッピングし、型(Type)を定義する作業は非常に退屈でミスの起きやすい工程です。本ツールはこのリバースエンジニアリング(推論)を自動化し、仕様書作成を加速させます。

API仕様書作成で役立つポイント

OpenAPIのスキーマは、フロントエンド、バックエンド、QA、外部連携先が同じレスポンス構造を確認するための共通言語になります。サンプルJSONから初期スキーマを生成しておくと、プロパティ名、型、配列構造、ネストされたオブジェクトを手早く整理できます。
手作業で作った仕様書では、実際のAPIレスポンスとドキュメントが少しずつずれることがあります。実レスポンスを貼り付けてスキーマ化し、既存のOpenAPI定義と比較することで、追加された項目や型の変更をレビューしやすくなります。

生成後に確認したいこと

JSONのサンプルだけからは、必須項目、nullable、列挙値、文字列のフォーマット、数値の範囲までは完全には判断できません。生成結果を出発点として、requireddescriptionexampleformat などを追記すると、読み手にとって使いやすいAPI仕様になります。機密情報を含むレスポンスを扱う場合は、値をマスクしてから入力してください。

このツールの関連記事

最新記事

活用事例
2026-07-14

MermaidのER図(erDiagram)記法リファレンス|リレーション記号一覧と実例

Mermaid erDiagramの書き方を網羅解説。カラスの足記法の記号一覧表、1対多・多対多の書き分け、属性・PK/FKの定義、実務で使えるEC設計の完全サンプルまで。

ツール紹介
2026-06-23

IP/CIDR サブネット計算機 ― ネットワーク・ブロードキャスト・マスクを即算出

192.168.1.10/24 のような CIDR から、ネットワークアドレス・ブロードキャスト・利用可能ホスト数・サブネットマスク・ワイルドカードを計算する方法と早見表を解説します。

ツール紹介
2026-05-06

SQLビルダーでSELECT・JOINクエリを視覚的に作成する方法

SQLビルダーを使ってSELECT、WHERE、JOINをブラウザ上で組み立てる方法を解説。SQL初心者の学習、データ抽出、レビュー前の確認に役立ちます。

ツール紹介
2026-05-02

CSVとJSONを相互変換する方法:API連携・データ移行での使い分け

表形式のCSVと構造化データのJSONを安全に変換するための考え方、ヘッダー行、区切り文字、型の扱い、実務での注意点を解説します。

ツール紹介
2026-05-02

JSON整形・検証の基本:APIレスポンスを読みやすく安全に確認する方法

APIレスポンスやログに含まれるJSONを整形し、構文エラーを見つけ、型生成やスキーマ化へつなげる実務的な確認手順を解説します。

ツール紹介
2026-02-25

インフラ構成図をブラウザで作成する方法|Mermaid対応

サーバー、DB、ネットワークの構成をGUIで整理し、Mermaidコードや画像として出力する方法を解説します。