問題タブ [swagger-node-express]

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 投票する
1 に答える
7043 参照

swagger - anyOf: {$ref} in swagger JSON スキーマ定義

JSON API を記述するためにswaggerを使用しようとしています。これまでのところ良さそうに見えますが、JSON 回答でさまざまなオブジェクト型の配列を定義するために anyOf 構造を使用する方法がわかりません。

次の JSON スキーマは有効であり、Article および Video JSOn オブジェクトの配列を記述する必要があります。

ただし、swagger では、オブジェクト タイプは常に「記事またはビデオ」ではなく未定義として表示されます。

これを機能させるために闊歩することはまったく可能ですか?

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

json - ノード js の swagger UI で json 形式の検証を追加する

こんにちは、node.js アプリケーションで API を文書化するために swagger UI を使用しています。正常に構成され、正常に動作しています。

しかし、私は今、1つの深刻な問題に直面しています。

これが私のコントローラーからのサンプルのswaggerコードです

これには、次のような形式でpayload値を取るパラメーターがありますjson

しかし、私invalid json

その後、サーバーがクラッシュしています。このパラメーターに検証を追加する必要があるため、この特定のパラメーターに検証を追加するにはどうすればよいですか。

0 投票する
2 に答える
29862 参照

restful-url - swagger-ui の使用を開始するにはどうすればよいですか

swagger-ui とは何ですか? また、その用途は何ですか?

http://swagger.io/にアクセスしましたが、さらに情報が必要です。

私を案内してください。

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

node.js - Swagger は古いバージョンの API を使用しています

Swagger を使用して API を文書化しようとしています。現在、ノードを使用して簡単な高速アプリをまとめました。私はswagger-node-expressを使用しており、ペットストアに関する例に従って基本的なGETをセットアップしようとしています.

ルートを試すと、次のエラーが表示されます。しかし、ネットワーク タブでは、GET が返されていることがわかります。

Swagger UI のスクリーンショット

swagger-node-express で使用できる Swagger の更新バージョンはありますか?

また、Swagger UIのページに「Build Failing」が表示されていることもわかりました。

基本的に、問題がswagger-node-expressにあるのか、それが使用しているswaggerバージョンにあるのかはわかりません。

誰かが同様の問題を抱えているか、修正を知っていますか?

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

swagger-ui - swagger-ui (新しい swagger-node プロジェクト) を介して読み取られるように、swagger API を利用できるようにします。

Express 4 で Swagger Node プロジェクトを使用して API をビルドしています。https://github.com/swagger-api/swagger-node

「swagger api」を機能させることはできますが、API を JSON として公開して Swagger-UI ( https://github.com/swagger-api/swagger-ui ) で読み取ることができませんでした。

どうすれば達成できますか?以前のバージョンでは次のメソッドを使用する必要があることはわかっています: swagger.configureSwaggerPaths("", "/api-docs", "");

しかし、プロジェクトの変更により、私は何と呼ぶべきか..

タイ

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

swagger - Swagger-Node でブール値を返すエラー

私はswagger-nodeが初めてで、ブール型のデータを返すAPIメソッドを作成しています。メソッドの yaml は次のとおりです。

この API メソッドが呼び出すコントローラーのメソッドは次のとおりです。

PostMan を使用してこのメ​​ソッドを呼び出すと、一部の検証が次のメッセージで失敗します。

データを含む応答を作成する方法がわかりません。文字列を型として使用する場合、またはブール値をカプセル化する新しい複合型を作成する場合は送信できますが、あまり良い解決策はないと思います...

何か考えはありますか?

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

node.js - node-restify パスは swagger で機能しますか?

node-restifyライブラリは、 のようなパスを許可します/foo/:id。そのようなパスを闊歩できますか? つまり何か?

アプリでこれを試すと、http://locahost:3001/api-docsページは次のようになります。

ダブルコロンを\文字でエスケープしてみました。しかし、それは違いはありませんでした。また、一重引用符を二重引用符に置き換えてみました。それでも違いはありません。swagger -nodeリポジトリからのフォークであるswagger-node-restifyライブラリを使用しています。私は何を間違っていますか?

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

node.js - Node.js 5.xv/s 0.10.x または 0.12.x

Node.js 5.x と 0.10.x または 0.12.x の 2 つのバージョンがあります。公式サイトからリンクhttps://github.com/nodesource/distributions

違いは何なのか、非常に混乱しています。ubuntu-server に swagger-node をインストールしようとしましたが、5.x を使用すると、 node-modules の巨大なセットが作成されます。ただし、0.10.x を使用すると、4 つのノード モジュールのみが使用されます。だから違いがあります。

私の質問は次のとおりです。

  1. 5.xv/s と 0.10.x の違いは何ですか?
  2. Ubuntu で 0.10.25 から 0.10.40 にアップグレードする方法は?