問題タブ [swagger]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
0 に答える
192 参照

django - Tastypie swagger には認証が組み込まれていますか?

login_requiredデコレータを使用するためにスワッガーを取得する方法はありますか? 私はいくつかのビューでそれを持っています:

これも使用するためにswaggerを取得する方法はありますか? ユーザーをログインページに自動的にリダイレクトするので、便利です。

0 投票する
1 に答える
389 参照

c# - リソースを異なる方法でグループ化する ServiceStack + Swagger 機能

まず、ServiceStack はフレームワークとしての私の期待をすべて上回っていると言うことから始めましょう。成し遂げたことは驚くべきことです。

私は現在 ServiceStack で Swagger UI プラグインを使用していますが、現在表示されているリソースとは別にリソースをグループ化する方法はあるのでしょうか? グループ化はルートによって決定されるようです。

現在のグループ化は次のようになります。

私はむしろ、次のようなものをswagger ui出力したいと思います:

以下に示すようにグループ化を使用して、上記のようなことができれば素晴らしいと思います。

これは ServiceStack の制限ではなく、Swagger の制限である可能性がありますが、質問したいと思います。

0 投票する
3 に答える
688 参照

tastypie - django-tastypie-swagger が Swagger の JS/CSS ファイルを提供しない

django-tastypie と django-tastypie-swagger を新しくインストールしました。

http://localhost:8000/tasty/doc/必要な HTML を提供しますが、それを機能させるために必要な CSS や JS をまったく取り込みません。

http://localhost:8000/tasty/doc/resources/作品とショー:

しかし、他のすべて (/schema/および静的ファイル) は 404 エラーを返します。

0 投票する
1 に答える
2331 参照

guice - Swagger と Google Guice のセットアップ

プロジェクトに闊歩を追加しようとしています。私たちのセットアップは、サンプル プロジェクトとは少し異なります。guice と guice-servlet を使用して、JerseyServletModule を注入して開始します。

今日、web.xml は次のようになります。

クラス MyServletModule は次のようになります

どこにどのようにswaggerを追加すればよいですか?

0 投票する
3 に答える
32957 参照

javascript - Swagger で API キーを URL ではなく http として送信する方法

サービススタックで swagger を使用していますが、API キーが必要なため、/resources URL から 401 無許可エラーが発生します。

私が間違っていない限り、ドキュメントによると、html ページから Swagger を初期化するときに JSON パラメータのapiKeyNameapiKeyの値と同様にsupportHeaderParamsを true に設定する必要があります。

次に、http 要求ヘッダーに API キーが表示されることを期待していましたが、ヘッダー コレクションではなく、まだ URL に追加されています。

HTML ページで Swagger を初期化するコードは次のとおりです。

残念ながら、「Api-Key」または「testheader」というヘッダーはまったく得られません。

0 投票する
1 に答える
2432 参照

java - 複数の注釈を 1 つにまとめて、重複を避ける

Spring MVC を使用して、さまざまな REST サービスの実装に取り​​組んでいます。ドキュメントには、Swagger を使用しています。

これはうまく機能し、ドキュメントは見栄えがよく、本当に機能的です。私が抱えている唯一の問題は、ドキュメントの注釈、特にエラー コードの注釈が実際にコントローラー クラスを混雑させていることです。

例:

多くの場合、これにより、実際のアプリケーション コードがその間のどこかに隠されている注釈の大きなブロックが発生します。さらに、多くのメソッドが同じエラー コードのセットを返す可能性があるため、この注釈セットはしばしば繰り返されます。

注釈リストを別のクラスファイルの定数として別の場所で定義することで、これを少し短縮するオプションはありますか? それとも、私が見落としているかもしれないもっと単純なものでしょうか?

@ApiErrorどこかで項目の配列を定義しようとしましたが、これはコンパイルされません:

誰かがこの問題を解決する方法を教えてくれたらうれしいです。事前に感謝します!

0 投票する
3 に答える
21195 参照

wcf - WCF REST での Swagger の使用

Swagger を追加したい WCF REST ベースのサービスがあります。Swagger.NET パッケージをインストールしました。私のプロジェクトは .NET 4.0 を使用しています。XML ドキュメントなども有効にしましたが、ここからの最適なルートがわかりません。

起動http://localhost/SwaggerUI/index.htmlすると、デフォルトのページが表示されますhttp://YOUR-URL-HERE:PORT/api/swagger。ここにどの URL を入力すればよいかわかりません。私は次の方法でサービスのヘルプを有効にしました。これにより、<standardEndpoint name="" helpEnabled="true" />ここに醜いページが表示されます: http://localhost/api/help--それをSwaggerにプラグインすると、結果が得られます:

続行する最善の方法は何ですか。私は WebApi を使用していませんが、それが役立つ場合は多くの機能を利用できます。

0 投票する
0 に答える
652 参照

json - プレースホルダー抽象クラスの拡張クラス json スキーマの生成

Swagger で生成された Json スキーマでいくつかの問題に直面しています。

タイプ抽象クラスの1つの基本クラスがあります。そして、2 つのクラスがこの基本クラスを拡張します。また、メイン転送オブジェクト object には抽象クラス フィールドが含まれているため、2 種類の拡張クラスの共通のプレースホルダーとして機能します。

これは、Jackson アノテーションを使用して実現できます。しかし、Swagger はジャクソンの注釈を尊重しています。

ジャクソンの使用:

Swagger は、タイプ基本クラスのオブジェクトを渡す必要があると言っていますが、拡張クラスの詳細を使用して json スキーマを構築し、それを表示する必要があります。

Swagger json スキーマは次のようになります。

しかし、私は拡張クラスも拡張するために闊歩したい。

ジャクソンの注釈を使用するように闊歩させる方法はありますか?