SwaggerHub に OpenAPI 3.0 コード生成を導入

  2018年9月25日

SwaggerHubがOpenAPI Specification 3.0 (OAS 3.0)によるコード生成の初期サポートを発表できることを大変嬉しく思います!

OAS 3.0のコード生成は、Swagger 2.0からOAS 3.0へ移行するチームが増えるにつれて、最も要望の多かった機能の1つでした。今回の初期リリースは、サポートされる言語の第一弾であり、最もよく使われているサーバースタブとSDKオプションの一部が含まれています。

クライアントSDK

  • html2
  • java
  • php
  • swift3
  • swift4
  • typescript-angular

サーバスタブ

  • jaxrs-di
  • jaxrs-jersey
  • jaxrs-resteasy
  • jaxrs-resteasy-eap

今すぐログインして、新規または既存のAPI定義を開き、定義エディター右上の「エクスポート」メニューからコード生成オプションにアクセスできます。

SwaggerHubの強力な2.0から3.0への変換機能や、これらのSDKを任意のレポジトリシステムに簡単にプッシュできる機能と組み合わせることで、チームはOAS 3.0を標準化し、OpenAPI Specificationの最新バージョンの機能を最大限に活用しやすくなります。OAS 3.0コード生成のサポートに加え、チームはプラットフォームの使いやすさを向上させるためのいくつかの追加を行いました。

エディター体験をカスタマイズ

ユーザーから、より良いデザイン体験のためにSwaggerHubエディターをカスタマイズしたいという多くのフィードバックが寄せられました。エディターは、可変フォントサイズからより幅広いカラーパレットオプションまで、読みやすさを向上させるためにいくつかの調整が行われました。

また、ユーザーから指摘されていたパフォーマンスの問題に対処するため、舞台裏でいくつかの微調整も行いました。

コメントの直感的な通知

コメントは、設計およびレビュープロセス全体で変更を伝え、問題を追跡するために使用できます。

コメントに導入された小さな改善点の1つは、ユーザーが解決待ちのリクエスト数を表示できるようになったことです。どのコメントが対処されたかを確認するために問題を検索する必要がなくなり、未解決のコメント数を一目で確認できるようになりました。

スタイルバリデーターに新しいルールを追加

SwaggerHubのスタイルバリデーターツールは、一連のAPI全体で強制できるスタイルルールを選択することで、チームがAPI設計プロセスを標準化するのに役立ちます。スタイルバリデーターのルールリストに3つの新しいオプションを追加しました。

  • オペレーションは1つだけタグを持つ必要がある
  • オペレーションは少なくとも1つの2xx応答を持つ必要がある
  • オペレーションはデフォルトの応答を持つ必要がある

これらの新機能と機能をSwaggerHubに提供できることを嬉しく思います。新しいバージョンの仕様をチームがどのように創造的に活用するかを見るのが楽しみです。

これらの新機能を今すぐお試しください。ログインして開始。SwaggerHubは初めてですか?今すぐ無料で開始。 

お読みいただきありがとうございます!APIリソースをもっとお探しですか?Swaggerニュースレターを購読してください。毎月、最高のAPI記事、トレーニング、チュートリアルなどがメールで届きます。 購読