問題タブ [swagger-3.0]

私のサーバーアプリケーションjsonは、次の形式で応答を送信します

additional-info成功メッセージ (「操作が成功しました」など)、エラー メッセージ (「操作が失敗しました」など)、または文字列形式のオブジェクト ( {user-name: manu}.

swagger上記のオブジェクトの定義を次のように作成しました。

次に、次のようにAPIで上記の定義を使用しようとしています

私の問題は、現時点では、ServerFailureResponseまたは何が含まれるServerSuccessResponseかわかりません. additional-infoに含まれるものも明確になるように API 定義を再設計したいと考えていますadditional-info。私ができる方法はありますか？additional-infoコードでは、まだラッパーとして使用したいです。私が欲しいのは、各応答Swaggerの内容が明確であることだけです。additional-info

これは、エンコーディング オブジェクトの例が OpenApi で行われる方法です https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md

私は同じことを達成しようとしていますが、swagger-php を使用しています。私が知らないのは、デフォルトで次のようにエンコードされているため、プロパティを次のようencodingsに@OA\MediaTypeエンコードするために渡す方法ですtestmultipart/form-dataapplication/json

元：

ここにいくつかの例があります：

https://github.com/zircote/swagger-php/tree/master/Examples

しかし、エンコーディングに関する例は見つかりませんでした

ここでフィールドが定義されてい ます https://github.com/zircote/swagger-php/blob/master/src/Annotations/MediaType.php

やってみencoding={"recommended"={"contentType"="multipart/form-data"}}たけど駄目。

api_xxx現在、私の API はの代わりにusernameとのapi_xxy代わりにBasic 認証を使用しpasswordていますが、そのような状況のための特定のスキーマはありますか?

すべてがまったく同じように機能します。ユーザー名とパスワードの UI のラベルのみを変更したいと思います。

次の機能は、次のように説明されています。