JSON → OpenAPI スキーマ生成
JSON を貼り付けるだけで OpenAPI のコンポーネントスキーマを作成します。
オブジェクトや配列を JSON Schema として必須項目付きで組み立て、混在する配列は oneOf で表現します。
すべてブラウザ内で完結し、データがサーバーに送信されることはありません。
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、列挙値、文字列のフォーマット、数値の範囲までは完全には判断できません。生成結果を出発点として、required、description、example、format などを追記すると、読み手にとって使いやすいAPI仕様になります。機密情報を含むレスポンスを扱う場合は、値をマスクしてから入力してください。
おすすめリソース
このセクションにはアフィリエイトリンクが含まれる場合があります。リンク経由で購入すると、追加費用なしでDevToolKits.appが紹介料を受け取ることがあります。
このツールの関連記事
JSONからOpenAPIスキーマを生成する方法|Swagger対応
JSONサンプルからOpenAPI 3.1のcomponents schemaを生成する仕組みを解説。型推論のルール、配列内の型混在をoneOfで表現する方法、日付文字列の自動検知、生成後に確認すべき項目まで整理します。
JSONエコシステム入門:整形・型生成・バリデーション・API定義を実例でつなぐ
JSONを起点にTypeScript型、Zodによる実行時バリデーション、OpenAPI定義へと展開する一連の流れを、実際のコード例でつなげて解説。型安全なAPI開発の全体像がわかります。
JSON SchemaとZodを相互変換する仕組み|requiredと.optional()の対応
JSON SchemaからZodスキーマを生成し、Zodのコードから逆にJSON Schemaを書き出す双方向変換ツールの実装を解説。requiredと.optional()で既定値が逆転している問題、formatや制約の対応表、コードを実行せずに解析する方法まで整理します。
JSON整形・検証の基本:APIレスポンスを読みやすく安全に確認する方法
APIレスポンスやログに含まれるJSONを整形し、構文エラーを見つけ、型生成やスキーマ化へつなげる実務的な確認手順を解説します。
最新記事
curlコマンドのオプション早見表|-X -H -d の意味と落とし穴
curlの主要オプションを早見表で整理。-X と -d の関係、-d と --data-raw の違い、@ で始まる値がファイル読み込みになる罠、シングルクォートとダブルクォートの使い分け、-L や -k を安易に付けない理由まで実例で解説します。
JSON SchemaとZodを相互変換する仕組み|requiredと.optional()の対応
JSON SchemaからZodスキーマを生成し、Zodのコードから逆にJSON Schemaを書き出す双方向変換ツールの実装を解説。requiredと.optional()で既定値が逆転している問題、formatや制約の対応表、コードを実行せずに解析する方法まで整理します。
SQLの句の評価順リファレンス|WHEREでSELECTの別名が使えない理由
SQLは書いた順に実行されません。論理的な評価順(FROM→WHERE→GROUP BY→HAVING→SELECT→ORDER BY→LIMIT)を軸に、別名がWHEREで使えない理由、WHEREとHAVINGの使い分け、ONLY_FULL_GROUP_BY、COUNT(*)とCOUNT(列)の差、LEFT JOIN+WHEREの罠を実例で整理します。
unified diff形式の読み方リファレンス|@@ の数字とgit diffの出力
git diffが出力するunified diff形式の読み方を整理。@@ -12,7 +12,9 @@ の4つの数字の意味、コンテキスト行、空白だけの変更が行全体の置換に見える理由、\ No newline at end of file、マージ時の @@@、リネーム検出の similarity index までを実例で解説します。
UTC⇄JST変換リファレンス|時差9時間の早見表とタイムゾーン事故の防ぎ方
UTCとJSTの変換を早見表で整理。ISO 8601のZと+09:00の意味、JavaScriptの日付パースでズレる条件、MySQL/PostgreSQLのタイムゾーン挙動、GitHub ActionsのcronがUTCで動く罠まで実例付きで解説します。
CREATE TABLE リファレンス|MySQL・PostgreSQL・SQLiteの型と制約の違い
CREATE TABLE文(DDL)の書き方を3データベース横断の早見表で整理。型対応表、自動採番(AUTO_INCREMENT / IDENTITY / rowid)の方言差、外部キーのON DELETE挙動、CHECK制約が無視される罠まで実例付きで解説します。