Лучшая практика для использования схем JSON v4 в Swashbuckle
У меня есть отличные схемы json v4.0 с проверочными выражениями и примерами. Я пытался поменять их как внешние $refs, но это не получилось хорошим вариантом со схемами Swashbuckle и json v4, так как эти $ refs также не проверяются с помощью валидаторов OpenAPI/Swagger. Если я ничего не делаю, я получаю что-то, что проверяется как OpenAPI и может быть использовано для генерации кода, но я хотел бы иметь возможность использовать существующие выражения проверки и примеры. Я думаю, что мне нужно сделать это в реализации ISchemaFilter и заменить только свойства и элементы примера. Если я правильно понимаю, это изменит схему в разделе определений сгенерированного файла swagger.json, и ссылки на него из различных сгенерированных путей должны включать эту желаемую информацию. Я на правильном пути?
Да, и еще одна вещь. Я обнаружил, что мне пришлось заменить скобки "[", "]" на "%5B" и "%5D" в откликах /"200"/schema/$ref для некоторых операций, которые возвращают списки объектов, чтобы пройти проверку когда я скачал сгенерированный файл swagger.json и отправил его для проверки в онлайн-валидатор. Я что-то здесь не так делаю? Или это дефект?