если среди уважаемых джентльменов и вуменов найдутся те, кто работал с openapi 3, не подскажете ли, как такое документировать?
есть разные схемы данных, к которым можно обратиться через $ref. но трабл в том, что каждый ответ апишки оборачивается в один и тот же враппер типа {success: true, message: "", data: {...}}
самое тупое решение - написать столько схем враппера, сколько есть схем данных, и документировать например ответ для /api/posts как $ref: '#/components/schemas/PostsWrapper. Но это максимально плохо