Я определил свой API служб с использованием OpenAPI3 и использую GitHub для связывания со Spectral, запустив следующий сценарий:
spectral lint ./api/**/*.{json,yml,yaml} --verbose
Позже я заметил, что многие объекты совместно используются в мои определения и вместо того, чтобы дублировать их, я решил создать общие файлы определений, на которые я мог бы ссылаться позже.
Все работает отлично, за исключением того факта, что на данный момент общие файлы - это просто обычные файлы YML и не определения OpenAPI. Это означает, что для этих файлов нет линтинга. Когда я попытался сделать эти файлы определением OpenAPI, мне пришлось добавить определение paths (и другие), которые не требуются в моих общих файлах.
Каков наилучший способ создания общей библиотеки в OpenAPI, который также может быть помечен?
Нечто подобное тому, что я сделал, вы можете найти в следующей ссылке