swaggerの仕様の確認にOpenAPISpecのrepositoryのjsonschemaを信用しない方が良い - Qiita
swaggerの仕様の確認にOpenAPISpecのrepositoryのjsonschemaを信用しない方が良い。 はじめに swaggerのspecはOpenAPI-Specificationとしてrepositoryがある。 このrepositoryの中に仕様自体のドキュメントもある。ところで、swagger spec(OAS)自体のjsonschemaもここに用意されているのだけれど。これがメンテされてなくて信用できないという話 nullableについて nullを許容するschemaをどのように書くかという話がある。このあたりの話は以下のissueを見るとわかる add "null value support" in spec? · Issue #229 · OAI/OpenAPI-Specification 結論から言うと以下の様になっている。 OAS2.0(swagger s
Swagger(OpenAPI) Specification 2.0におけるOptionalなプロパティに値が無い場合の仕様を調べた話 - yoskhdia’s diary
Swagger(OpenAPI) Specification 2.0（以下、OAS）を最近触り始めているのですが、Optionalなプロパティに値が無いときのJSONは何が許されるのかを調べたエントリです。 JSON Schema Specificationの requiredキーワード と type: null について確認しました。 OAS2.0ではModelはSchema Objectとして定義されており、これは JSON Schema Specification Draft 4 となっています。 OASでは、Schema Objectのrequiredキーワードおよびnullについて特に言及はありません。 そのため、JSON Schemaの仕様*1に準拠すると解釈し、これを調査しました。*2 TL;DR requiredキーワードに指定されていない（Optional）プロパティは、
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
