問題タブ [swagger-editor]
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.
yaml - Swagger で複合型 (定義) を作成する
Product
という定義と別のという定義を作成しましたText
(コードを参照)。
定義で作成した型parameters
がpaths
使えません。Text
定義Product
では、私は呼び出されたプロパティを持っており、message
そのプロパティもタイプにしたいですText
。
しかし、このエラーが発生します:
Swagger エラー: データが「anyOf」のスキーマと一致しません。
Text
type のtypeを参照するにはどうすればよいProduct
ですか?
api - YAML 構文エラー: 明示的なマッピング ペアが不完全です。キーノードがありません
YAML で Swagger 仕様を書いていますが、あいまいなエラーが発生します。私は正しいと思うパスと定義をマッピングしましたが、このエラーの意味がわかりません:
YAML 構文エラー 明示的なマッピング ペアが不完全です。行 66、列 30 にキー ノードがありません: format: int64schema: ^t
行:
スワガー:
次に、定義のswaggerファイルの下部に:
swagger - 追加のネスティング レイヤーを使用しない、swagger 仕様でのモデル構成
構成を介してSettings
定義が埋め込まれている次の例があるとします。Thing
Thing
editor.swagger.io でPOST するメソッドを定義すると、次のような JSON が構築されます。
モデル定義をコンポジションで埋め込みたいが、ネストされたプロパティ定義を追加せずに埋め込みたい - これは可能ですか? これは、私が持ちたいJSON構造ですThing
:
これを達成する方法はありますか?
swagger - データが「oneOf」のスキーマと一致しません - エラー
Swagger オンライン エディターで次のエラーが発生しています。 データが「oneOf」のスキーマと一致しません
エラーは、「parameters」で始まる行である行 206 を指すとおりです。
定義中の type: string を変更しようとしましたが、まだ運がありません。ここで適切な型の値が欠落していると確信しています。助けていただければ幸いです
ありがとうございます
swagger - 「承認: Bearer」を表すにはどうすればよいですか' Swagger Spec (swagger.json) 内
認証/セキュリティスキームでは、次のようにヘッダーを設定する必要があることを伝えようとしています:
これは、 swagger documentationに基づいて私が持っているものです:
swagger - JSON スキーマ オブジェクトの決定論的バージョン
Swagger Editorを使用して、API 用のカスタム JSON/YAML を作成しようとしています。Accept
基本的には、次のテンプレートのように、エンドポイントへの POST リクエストとContent-Type
ヘッダーと POST データを JSON の形式で記述したいと考えています{"document": "Some text paragraph", "documentType": "text/plain"}
。
これは私の swagger.yml ファイルです
Swagger エディターのエラー:
59 行目から定義が始まります。より具体的には、json
私は何を間違っていますか?
swagger - 同じファイルの定義でパラメーターを参照すると、Swagger エラーが発生する
swagger yaml ファイルの定義セクションで複数のパスで使用するいくつかのパラメーターを参照しようとしています。ドキュメントが期待どおりにレンダリングされ、要求が正しく作成されていても、try it out
ボタンを使用すると、このエラーが発生します。
実際のyamlはこれです
これは、別の例のswagger.yamlの最初の数行で構成され、定義内には同じフォルダー内のparameters.yamlがあります。
参照を微調整して、別のファイルではなく、同じファイル内の実際の定義を指すようにしました。この yaml をコピーしてオンライン エディターに貼り付けると、この正確なエラーが発生します。