20

最近、REST APIを簡単に解析/生成/公開するために使用しているクールな子供たちは何ですか？私はSwaggerを調べましたが、見た目は良さそうですが、私の観点からは、Rubyには適合しません。たぶん私は間違っていて、何かが足りないので、助けていただければ幸いです。

4

4 に答える 4

15

まだAPIを持っていないようですね。その場合、これが私が推奨するアプローチです。

  • swagger-specificationを使用して、APIのインターフェースを作成します。サーバーを使用せずにこれを行うことができます。ここを参照してください。

  • swagger-uiを使用してインターフェースを確認します。これにより、定義したすべてのエンドポイントを表示できます（jsonファイルを除いてコーディングは不要です！）

  • 必要なインターフェースができたら、swagger-codegenを使用してサーバーのスタブアウトバージョンを構築します。現在、nodejsとscalatraのテンプレートがあり、さらに多くのテンプレートが用意されています。新しいサーバージェネレーターを作成するには、いくつかの口ひげテンプレートを作成/変更するだけです。

  • swagger-codegenを使用してクライアントを生成することもできます。

これの利点は、APIのインターフェース駆動型開発を実行できることです。インターフェイスを構築し、空白を埋めます。配管はあなたのために行われます。

于 2012-08-30T21:51:00.283 に答える
8

このためにapipieで遊んで始めたところです。これまでのところ、かなりきれいに見えます。

于 2012-09-28T02:50:44.003 に答える
6

Swaggerをクライアントとしてrubyとともに使用すると、Swagger準拠のサーバーからクライアントライブラリを自動的に生成できますhttps://github.com/wordnik/swagger-codegen

RoRを使用する場合は、https：//github.com/elc/rapi_docを参照する必要があると思いますが、使用するのは簡単ではありません。

于 2012-04-24T08:22:49.507 に答える
5

ドキュメントについては、ApiDoco gem（https://github.com/72pulses/apidoco/）をご覧ください。セットアップは非常に簡単で、優れたユーザーエクスペリエンスを提供します。

于 2017-04-12T04:55:28.847 に答える