MM
Здесь)
Size: a a a
2021 December 06
CL
без понятия, увидел в обновлении про md и запостил сюда
CL
скажу больше что rst в дикой природе не встречал
ML
Вопрос: мы документируем сейчас API в OpenAPI и надо задокументировать евенты, которые могут вылетать из системы.
Их мы описали через oneOf
Хочется описать каждому варианту oneOf свой description, но кажется, что openapi никак не поддерживает description у объекта.
Это так? Если да, то как же описать варианты, куда этот текст положить?
Их мы описали через oneOf
Хочется описать каждому варианту oneOf свой description, но кажется, что openapi никак не поддерживает description у объекта.
Это так? Если да, то как же описать варианты, куда этот текст положить?
ML
выглядит, что другого способа, кроме как положить поле, указанное в discriminator, в каждую спеку и положить туда description, не видать
2021 December 07
NP
Возможно, нужен конкретный пример, чтобы понять проблему. У объекта то description как раз поддерживается. Сейчас специально вбил, и всё прекрасно... Другой вопрос, как oneOf кодогенерируется и документогенерируется... У нас, например, он запрещён к использованию, т.к. не поддерживается нашим генератором кода на Java
ML
А где у обьекта может бытьdescription?
Я облазил спеку и не нашел. Зато помогло описать дискриминационное поле
Я облазил спеку и не нашел. Зато помогло описать дискриминационное поле
ML
Даа, мы его заюзали
NP
ну вот, например, так не работает? У меня всё отлично... если не считать разработчиков
category:
description: abc
oneOf:
- $ref: '#/components/schemas/CategoryT1'
- $ref: '#/components/schemas/CategoryT2'
NP
документация поддерживает всё... а вот разработчики не всё
ML
Я не про физическую возможность, а про валидность по спеке.
Разве в спеке есть?
Разве в спеке есть?
NP
скажем так, спеку в этой части не читал, но валидатор принимает на ура
NP
а кто реджектит этот синтаксис?
ML
Я перепроверю