タグ

Swaggerに関するski_yskのブックマーク (2)

  • AutoRest - OpenAPI Specificationから各種プログラミング言語向けSDKを生成

    OpenAPI Specification(旧Swagger)の定義ファイルはドキュメントを生成するのによく使われます。しかし、それだけではなく他にも様々な使い道があります。例えばテストやバリデーションです。 さらにAutoRestを使えば各種プログラミング言語向けにSDKを生成してくれます。これは見逃せない機能でしょう。 AutoRestの使い方 実行例です。C#のコードを生成しました。 さらに指定を追加するだけでRubyのコードも生成できます。 AutoRestが対応するのはC#、GoJava、node、TypeScriptPythonRubyそしてPHPとなっています。これだけのプログラミング言語に対応していればまずは問題ないでしょう(Swiftも欲しいですが)。SwaggerCodegenという類似プロジェクトもありますが、AutoRestはOpenAPI Specifica

    AutoRest - OpenAPI Specificationから各種プログラミング言語向けSDKを生成
  • Open API designer - Open API/SwaggerドキュメントをWeb上で作成 MOONGIFT

    Swaggerをベースに現在策定が進められているのがOpen APIです。策定されれば多くのソフトウェアがそのフォーマットに対応することでしょう。そうなればAPIエコノミーがさらに広がっていくはずです。 今回紹介するOpen API designerはOpen APIのWebブラウザ上でデザインできるソフトウェアです。 Open API designerの使い方 まだ仕様が定まっていないこともあり、バージョンはSwagger 2.0となっています。 Schemes、Consumes、Produces、Pathsなどをそれぞれ追加できます。 追加した後は表示された項目に合わせて入力していきます。そうすると右側のJSONも更新されます。 複雑なOpen APIドキュメントもさくさくと作れるでしょう。 Swaggerドキュメントの多くはシステムから自動生成されるものです。しかし、時に手作業で書か

    Open API designer - Open API/SwaggerドキュメントをWeb上で作成 MOONGIFT
  • 1