問題タブ [swagger]

私は数週間 ServiceStack lib で遊んでいて、問題が見つかったようです。github から Swagger-UI のサンプル プロジェクトをダウンロードすると、RazorFormat 機能を追加するまで、すべて正常に動作します。次に、 localhost:50001/swagger-ui/index.html (以前は機能していました)を表示しようとすると、「Handler for Request not found」というエラーが表示されます。

では、swagger と razor の両方を使用するにはどうすればよいでしょうか。index.html の名前を index.cshtml に変更して、かみそりエンジンがこのファイルを処理できるようにしました。ページは機能していましたが、JS も CSS もダウンロードされていなかったため、あまり役に立ちませんでした。

ServiceStack.Swagger の問題は次のとおりです。

1) github から例をダウンロードします。2) HelloText クラス (または、この特定の例では、HelloImage または Hello など、REST サービスへの要求を記述している任意のクラス) に移動します。リクエストのルートをもう 1 つ追加します。

3) ローカルの swagger ページ (localhost:yourport/swagger-ui.html) またはリソース ページ (localhost:yourport/resources) に移動すると、"/abc/" ルートがキャプチャされ、"/hellotext" がキャプチャされていることがわかります。いいえ

これはバグですか、それとも意図した動作ですか? 複数のルートでswagger-uiを使用するには? または、リクエスト クラスをコピーして貼り付け、すべてのルートを独自のクラスに分割する必要がありますか?

Swagger-UIのフォークであるRestler3のAPI-Explorerを使用していますが、APIが返す応答JSONオブジェクトを文書化/説明する効果的な方法を誰かが見つけたかどうか疑問に思っています。明らかに、APIをインタラクティブに試してみると、「行間を読む」ような方法でこの一部を利用できますが、応答の構造をより詳細に示す方法が必要です。誰かがこれのために何かを思いついたことがありますか？

Swaggerを使用してRESTサービスを文書化しています。私のサービスの1つでは、CSVファイルをアップロードする必要があります。parametersJSONAPI定義のセクションに以下を追加しました。

SwaggerUIページにファイルアップロードオプションが表示されます。しかし、ファイルを選択して[試してみる]をクリックすると、次のエラーが発生します。

NS_ERROR_XPC_BAD_OP_ON_WN_PROTO：jquery-1.8.0.min.jsのWrappedNativeプロトタイプオブジェクトに対する不正な操作（2行目）

ページは継続的に処理されており、応答がありません。

何が間違っている可能性があるのか​​？

何らかの理由で、RestlerのAPI Explorer（Swagger UIのフォーク）を使用してAPIを本番環境にデプロイすると、ロード時に一般的な404エラーが発生します。

私がより明確で述べているとき：

ページのフレーミングをロードしますが、ヘッダーの下に赤いテキストで「404：NotFound../resources.json」と報告します。

同じファイルがローカルで機能するため、環境に問題が発生していることは間違いありません。ディレクトリ内の.htaccessファイルも確認しましたが、/api/explorer次のように表示されます。

どんな助けでもいただければ幸いです。

Restler v3 の最新バージョン (commit 0d79cd8) を使用していますが、Swagger ベースの UI が例と同じに見えるという問題があります。私が気付いている 2 つの問題は、変数の入力と @return オブジェクトが表示されないことです。

Restler のサイトでは、これらの両方が機能している良い例を次に示します。

例

代わりに、Actionsクラスでこれを取得します。

それでも、クラスの定義からわかるように、型情報と応答オブジェクトの両方が指定されています。

私の ActionList クラスの定義は次のとおりです。

ServiceStack.Api.Swagger v3.9.33API 操作の応答と返されたステータス コードを で記述することはできますSwaggerか? おそらく、Response クラス/プロパティなどの属性の装飾によるものです。

ペット ストア API からの次の操作例の強調表示されたセクションのように: ( http://petstore.swagger.wordnik.com/ )

私は HTTP メソッドしか見ることができず、リクエスト DTOS はhttps://github.com/ServiceStack/ServiceStack/wiki/Swagger-APIで装飾できます。 com/ServiceStack/ServiceStack/tree/master/src/ServiceStack.Api.Swagger

RestlerのAPIExplorer（Swagger UIのフォーク）を使用しています。そこでサービス呼び出しをテストすると正常に機能しますが、同じURLを切り取ってChromeのAdvanced RESTクライアントに貼り付けると、「403Forbidden」エラーが発生します。どうしてそれができるのでしょうか？リクエストで渡す必要のある必須のヘッダーパラメータはありますか？

スクリーンショットは次のとおりです。

Luracast Restlerと Restler のAPI Explorer ( Swagger UIのフォーク)の書き換えの問題に取り組んでいます。OSX マシンの localhost で完全に動作する開発環境を使用していますが、同じファイル (.htaccess ファイルを含む) が、Ubuntu を実行している製品前のボックスでは動作しません。どちらの場合も httpd.conf ファイルにアクセスでき、何らかの回答を求めてそれらに注ぎ込みました。確かに、mod-rewrite はまだ私にとってある種の闇の魔法なので、他の人からアドバイスをもらいたいと思っています。

httpd.conf に次のエントリを追加して、両方の環境でログを有効にしました。

これにより、プリプロダクションでいくつかの興味深い結果が得られます。を呼び出すとhttp://website.com/api/explorer、次のようになります。

興味深いことに、私には説明がつきませんが、ローカル環境で同じ URL を呼び出してもまったくログが記録されないことです (0 バイトのログがあるため、httpd.conf で正しく構成したと思います)。ローカル環境 (Restler WORKS) には/api/explorer、/api/explorer/index.html.

の .htaccess ファイルは/api/explorer次のようになります。

その中/apiには：

アップデート

@faa の提案に基づいて、.htaccess ファイルにベース パスを追加しました。

また[QSA,L]、ルールのパラメーターを に変更しました[QSA,L,DPI]。ログには次のように記載されています。

私が困惑するのは、これを正しく読んでいる場合、次のことです。

• 「」から「index.html」に正しくリダイレ​​クトします
• しかし、2行目の「接頭辞を置き換えようとする」は完全に冗長なようです
• そしてなぜ!#?! 「/var/www/html/api/explorer/index.html」で内部リダイレクトを行いますか?

私がこれを行うと、次のls -l /var/www/html/api/explorer/index.htmlようになります。

明らかにこのファイルが存在し、apache がこのコンテンツを提供するためのパーミッションは問題ありません。

更新 2

次のような.htaccessファイルを持つルートにWordpressをインストールしたことも注目に値します（ところで、これはデフォルトのWPと一般的なW3 Total Cacheプラグインです）：

ServiceStack の SwaggerUI 実装状態のドキュメント

デフォルト設定では、ServiceStack サービスが「/api」パスで利用できることが想定されています。

しかし、私は自分のAPIをルートに持っています。SwaggerUI の外観を変更する方法はありますか?