Мне очень нравится, как RAML фокусируется на уменьшении количества дублирования и повышении согласованности API-интерфейсов с использованием ResourceTypes и Traits.
Но после более детального изучения спецификации Swagger, вы можете сделать то же самое, используя $ ref.
Есть ли преимущество в RAML над $ ref в этом сценарии? Я что-то упускаю?
После того, как я углубился в это, я лучше понимаю, как это работает.
Одно большое отличие заключается в том, что ResourceTypes в RAML принимают параметры, которые позволяют извлекать больше кода.
Кроме того, он ограничен, где вы можете использовать $ ref в swagger. Значит, вы не можете применить $ ref на уровне ресурсов или методах http. Примерами вещей, которые вы можете выделить, являются параметры, ответы и модели.
ResourceTypes и черты являются более мощными в экстернализующем общие закономерности в REST и повторно использовать их в различных услугах
Я использую черты для определения спецификации несколько заголовков в Raml. У меня есть несколько заголовков, которые повторно используются во множестве ресурсов. Теперь я пытаюсь переключиться с RAML на swagger. Копирование встроенных определений заголовков кажется мне полным перегибом. Вы знаете, могу ли я снова использовать черты для заголовков в чванстве? – ducin