フィードバックを投稿するのに最適な場所かどうかわかりませんが、関連するGithubリポジトリでIssueの投稿ポータルが閉じられているため、ここでフィードバックを提供しようと思います。 GitHub - discourse/discourse_api_docs: Discourse API Documentation GitHub - discourse/discourse_api_docs: Discourse API Documentation でホストされている openapi.json ファイルは、実際には有効な openapi ファイルではありません。 詳細はこちらをご覧ください Discourse openapi.json generate issue · Issue #277 · mattpolzin/OpenAPIKit · GitHub TL;DR array スキーマの items キーは "有効な JSON スキーマでなければなりません" (json-schema.org/draft/2020-12/json-schema-core.html#section-10.3.1.2-1) であり、JSON スキーマは "オブジェクトまたはブール値でなければなりません" (json-schema.org/draft/2020-12/json-schema-core.html#section-4.3-2)。OpenAPI ドキュメントのこの部分は JSON スキーマのルールによって管理されているため、OpenAPI 仕様自体にはそれらのルールの多くを記載していない可能性があります。
フィードバックを投稿するのに最適な場所かどうかわかりませんが、関連するGithubリポジトリでIssueの投稿ポータルが閉じられているため、ここでフィードバックを提供しようと思います。 GitHub - discourse/discourse_api_docs: Discourse API Documentation
GitHub - discourse/discourse_api_docs: Discourse API Documentation でホストされている openapi.json ファイルは、実際には有効な openapi ファイルではありません。
詳細はこちらをご覧ください Discourse openapi.json generate issue · Issue #277 · mattpolzin/OpenAPIKit · GitHub
TL;DR
array スキーマの items キーは "有効な JSON スキーマでなければなりません" (json-schema.org/draft/2020-12/json-schema-core.html#section-10.3.1.2-1) であり、JSON スキーマは "オブジェクトまたはブール値でなければなりません" (json-schema.org/draft/2020-12/json-schema-core.html#section-4.3-2)。OpenAPI ドキュメントのこの部分は JSON スキーマのルールによって管理されているため、OpenAPI 仕様自体にはそれらのルールの多くを記載していない可能性があります。
array
items
"有効な JSON スキーマでなければなりません"
"オブジェクトまたはブール値でなければなりません"
Discourse の openapi.json は rswag という名前のツールによって生成されます。
これはおそらくアップストリームの問題です。アップストリームが修正したら、依存関係のバージョンをアップグレードし、対応するドキュメントファイルを更新する必要があります。
PR above ^ は実際にはここで下流で対処されました。
