# Документация openapi.json для Discourse не соответствует спецификации OpenAPI 3.1.0

**URL:** <https://meta.discourse.org/t/discourse-openapi-json-docs-does-not-follow-openapi-3-1-0-spec/268932>\
**Category:** Bug\
**Tags:** rest-api\
**Created:** [19.Июнь.2023 18:06:03 UTC](https://meta.discourse.org/t/discourse-openapi-json-docs-does-not-follow-openapi-3-1-0-spec/268932 "2023-06-19T18:06:03Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![Kyle-Ye](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/kyle-ye/32/309787_2.png) [@Kyle-Ye](https://meta.discourse.org/u/Kyle-Ye)\
**Post date:** [19.Июнь.2023 18:06:04 UTC](https://meta.discourse.org/t/discourse-openapi-json-docs-does-not-follow-openapi-3-1-0-spec/268932/1 "2023-06-19T18:06:04Z")

</div>

> Не уверен, что это лучшее место для такой обратной связи, но в соответствующем репозитории GitHub закрыт портал для создания задач (Issues), поэтому я пытаюсь оставить отзыв здесь.  
> [GitHub - discourse/discourse\_api\_docs: Discourse API Documentation · GitHub](https://github.com/discourse/discourse_api_docs)

Файл openapi.json, размещённый по адресу [GitHub - discourse/discourse\_api\_docs: Discourse API Documentation · GitHub](https://github.com/discourse/discourse_api_docs), на самом деле не является валидным файлом OpenAPI.

Подробнее см. здесь: [Discourse openapi.json generate issue · Issue #277 · mattpolzin/OpenAPIKit · GitHub](https://github.com/mattpolzin/OpenAPIKit/issues/277)

TL;DR 👇

> Ключ `items` для схемы `array` «ДОЛЖЕН быть валидной схемой JSON» ([json-schema.org/draft/2020-12/json-schema-core.html#section-10.3.1.2-1](https://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](https://json-schema.org/draft/2020-12/json-schema-core.html#section-4.3-2)). Поскольку эта часть документа OpenAPI регулируется правилами JSON Schema, в самой спецификации OpenAPI, вероятно, не стоит упоминать слишком многие из этих правил.

---

_[View the full topic](https://meta.discourse.org/t/discourse-openapi-json-docs-does-not-follow-openapi-3-1-0-spec/268932)._