2015-10-15 6 views
0

Мне нравится Swagger и все его инструменты. Мне нравится HAL, потому что я могу создать/следовать API-интерфейсу для обнаружения. Являются ли эти два взаимоисключающих или я могу использовать swagger для реализации HAL-интерфейса для обнаружения?Насколько HAL и Swagger сопоставимы?

ответ

0

Вы можете определенно использовать swagger для описания ссылок в ответах, и в этом есть значение. Однако исследователь swagger-ui не будет автоматически следовать за ними (если только ответ не является 301/302), поэтому вы потеряете некоторые функции «попробуйте сейчас».

+0

Эй, спасибо за это. Вы можете расширить этот ответ? Что вы имеете в виду, попробуй сейчас? Что вы подразумеваете под swagger-ui explorer, не по ссылкам? – Stewart

+0

Если вы посмотрите пример подключения swagger-ui к серверу (например, http://petstore.swagger.io), вы заметите, что выполнение операции вернет полезную нагрузку и отобразит ее в пользовательском интерфейсе. Если полезная нагрузка содержит ссылку на ресурс, который является типичным для ресурса HAL, он не будет ссылаться на ссылку, он просто отображает то, что видит в ответе. – fehguy

Смежные вопросы