swagger-2.0

1熱

1答えて

まずは、このSwagger PHPについてとても興奮しています。スワッガーアノテーション内でPHP変数を使用できる方法はありますか。以下はは私のコードです： define('API_PATH', '/api/demo'); /** * @SWG\Swagger( * basePath="{API_PATH}", * host="11.7.11.16:xxxx", * schemes=

3熱

1答えて

Swagger 2.0は不純なREST APIデザインを有効にしますか？

現在のSwagger仕様では、Swaggerをとして使用して、RESTful APIを記述して文書化しています。私は、これはむしろ私が闊歩は、単にいくつかの理由のためにHTTP APIを記述するために有用であると考える場合ではないと思う：闊歩仕様はPathとDefinitionような要素を持っていますが、彼らは明確にマッピングされませんREST data elementsは、リソース、表現、メデ

9熱

1答えて

Swaggerのデータ注釈

私は、POSTを受け入れる複雑な型を公開するASP.NETとSwaggerを使用しています。制限された長さが異なる複数の文字列フィールドがあります。それをSwaggerのUIに反映するにはどうすればよいですか？

6熱

2答えて

Swagger 2.0 Anyof

Swaggerバージョン2.0のanyofに相当するものは何ですか？私のjsonファイルを更新する方法を教えてください。ドキュメントをswagger 1.0から2.0にアップグレードしたいからです。ありがとうございました。

7熱

3答えて

Swashbuckle Swagger - コンテンツタイプに注釈を付ける方法は？

Swaggerメタデータが自分のリソースでサポートされているコンテンツタイプを含むように、ASP.NET WebAPIアクションに注釈を付けるにはどうすればよいですか？具体的には、私はドキュメントが私の資源の一つは、「オリジナル」application/jsonとapplication/xmlを返すだけでなく、新しい形式、application/vnd.blah+jsonまたは+xmlを返すこと

12熱

3答えて

闊歩2.0基本認証スキーマ

を宣言するはどのようにして闊歩2.0アノテーションを使用して基本認証を定義し、それが闊歩のUIに表示されています。私が持っているリソースの場合： https://github.com/swagger-api/swagger-core/wiki/Annotations#authorization-authorizationscope をそして、あなたはあなたがあなたのAPIでサポートする認証方式

8熱

1答えて

Swagger EditorとGitまたはGitHubの統合

私は現在、ネットワーク上でローカルにSwagger Editorを使用しています。エディタがgitサーバからファイルを直接インポートできる可能性はありますか？私はAPIを定義しています。これを安全にするだけでなく、他のプログラマーと共同作業するためにgitで使用したいと考えています。ありがとうございました。

5熱

1答えて

Swagger/Open API 2.0では、共通の応答ヘッダーを宣言できますか？

すべての応答に存在するカスタム応答ヘッダーを、応答構造ごとにコピーせずに宣言することは可能ですか？

12熱

1答えて

Swagger ApiModelPropertyアクセス

私は残りのエンドポイントで自分のリクエストとレスポンスに同じオブジェクトを使用しています。 ApiModelProperty（access = "response"）でプロパティに注釈を付けることは可能ですか？ @ApiImplicitParam（access = "response"）で残りのエンドポイントメソッドに注釈を付けるように、プロパティは応答オブジェクトのスワッガードックにのみ表示さ