問題タブ [openapi]

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 に答える
11595 参照

swagger - Swagger UI でのマルチレベル (ネストされた) タグ付け

最近、Swagger 2.0 API の作業を開始しました。API ドキュメントを整理する方法を探しています。

現在、@Api(tags = {"Heading1"})Java アノテーションを使用して各 API にタグを付けています。生成されたドキュメントは次のようになります

次のように、ドキュメントにいくつかの小見出しを追加したいと思います

どうすればこれを達成できますか?

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

google-app-engine - Google エンドポイント クイックスタート アプリをデプロイすると、URL をリクエストするとエラー メッセージが表示されますか?

スタンダード環境の App Engine 上の Cloud Endpoints Frameworks のクイックスタートに従っています。サンプル API をデプロイしました。https://[my-project].appspot.com/を開くと、次のエラー メッセージが表示されます。

ログに次のメッセージが表示されます。

app.yaml ハンドラーは、endpoints-frameworks-v2/echo サンプルに付属しているものです。

クイックスタートの前のステップで、OpenAPI 構成ファイルを生成するのに非常に苦労しました。SDK のシステム変数パスを更新することで機能するようになりましたが、次のエラーが発生しました。

このエラーが現在の問題に関連しているかどうかはわかりません。

どんな助けでも大歓迎です。

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

swagger - Swagger: ワイルドカード パス パラメーター

私は、任意のパスを渡すことができる API を持っています。たとえば、次のすべてです。

  • /api/tags
  • /api/tags/foo
  • /api/tags/foo/bar/baz

有効なパスです。私はそれを次のように説明しようとしました:

ただし、https://generator.swagger.ioはパス内のスラッシュをエンコードするため、機能しません。Swagger で API を記述する方法はありますか?