а у вас митапы по тем дням, когда у меня тренировки

а про завтрак на рынке я просто забыл =(

Ребят, как вы описываете документацию api  на swagger?
Вручную описываете в json/yaml или с помощью библиотек?
Сейчас использую fastapi. Все здорово, автоматически генерируется. Но оказалось, что необходимо дополнить эту документацию, поскольку другая часть api реализована на с++. Как это сделать не совсем понимаю, кроме как подкидывать fastapi локальный json/yaml. Либо вообще разворачивать отдельный сервер документации, чтобы не зависеть от fastapi.

Дополнить в каком плане?

fastapi генерирует доку для методов, которые я описал в коде на питоне.  К описанию  этих методов нужно добавить описание  методов из c++

А, понял
Насколько я помню, там механика генерации openapi в fastapi не самая приятная, и что-то туда инджектить будет больно
Я бы, наверное, dummy-эндпоинты написал, чтобы по сигнатурам и докстрингам генерилась openapi, а в самих функциях, не знаю, взрываться, редиректить, что угодно

А, ну или вот
https://fastapi.tiangolo.com/advanced/extending-openapi/#generate-the-openapi-schema

+

В принципе, можно поразбираться что возвращает get_openapi, и после вызова туда своё что-то засунуть

А кстати, там можно как-то исключения прописывать в доке, кроме 422?

Да, как-то можно
Щас попытаюсь вспомнить как

https://fastapi.tiangolo.com/advanced/openapi-callbacks/
Или даже так, кажется это прям твой кейс

Пасеба!

Уф, неудобно

Я ожидал увидеть что-то вроде raises=BadRequestError

И забирать модель ответа из класса исключения

Да, такое

+

Как раз сейчас хотел погуглить, как это делается, зашёл в чат и увидел, что делается по-уродски