本文へスキップ
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: よくある質問

  • 生成されるのは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仕様になります。機密情報を含むレスポンスを扱う場合は、値をマスクしてから入力してください。

おすすめリソース

このセクションにはアフィリエイトリンクが含まれる場合があります。リンク経由で購入すると、追加費用なしでDevToolKits.appが紹介料を受け取ることがあります。

このツールの関連記事

最新記事

ツール紹介
2026-08-03

テーブル設計からCREATE TABLE文を自動生成する仕組み|DDLビルダー

テーブルをビジュアルに設計してCREATE TABLE文とER図を生成するDDLビルダーの実装を解説。MySQL/PostgreSQL/SQLiteの型変換ルール、JSONサンプルからのカラム推論アルゴリズムまで実例付きで整理します。

活用事例
2026-07-21

GitHub Actions needs設計パターン集|CIを速くする依存関係の組み方とアンチパターン

GitHub Actionsのneedsによるジョブ依存関係を、高速化パターンとアンチパターンの一覧表で整理。concurrencyによる重複実行キャンセル、fail-fast、matrix×needsの組み合わせ、再利用可能ワークフローまで実例付きで解説します。

活用事例
2026-07-21

SQL JOIN完全リファレンス|INNER・LEFT・RIGHT・FULLの違いと結果行数の考え方

SQLのJOIN種類(INNER/LEFT/RIGHT/FULL/CROSS/SELF)を早見表と結果行数の図解で整理。1対多JOINで行が重複する理由、WHERE句とON句でNULL判定が変わる罠、複数テーブルJOINの書き方まで実例付きで解説します。

ツール紹介
2026-07-16

Case Converter ― camelCase・snake_case・kebab-caseを9種類まとめて一括変換

識別子や変数名をcamelCase・PascalCase・snake_case・CONSTANT_CASE・kebab-caseなど9種類の命名規則へ同時変換する方法を解説。連続大文字(HTTPServer)や数字の扱い、複数行の一括変換まで。

ツール紹介
2026-07-16

LLM APIコスト計算機 ― Claude・GPT・Geminiの料金を同じ条件で見積もり比較

プロンプトを貼り付けて想定出力トークン数を入れるだけで、Claude・GPT・GeminiのAPI利用コストをモデル横断で見積もる方法を解説。入力/出力の単価構造、料金の自動更新、概算の限界まで。

活用事例
2026-07-14

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

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

広告

広告