Ссылки HATEOAS с PUT/POST

Question

Что было бы лучшим способом представить ссылку HATEOAS для POST/PUT/PATCH на ресурсе? Эти операции имеют полезную нагрузку, но у нас не будет возможности представлять полезную нагрузку в ссылке HATEOAS, поскольку они не предопределены и могут быть тяжелыми. Так достаточно ли просто указывать конечную точку и указывать операцию?

Любые образцы или примеры были бы весьма полезны для ответа JSON с HATEOAS POST/PUT/PATCH ссылка.

Answer 1

Ссылки состоят из двух элементов: href и rel. href содержит явный URL-адрес для поиска ресурса. rel определяет связь между текущим ресурсом и ресурсом ссылки. rel следует использовать для определения приемлемого метода HTTP и способа использования ссылки.

Следующая цитата из RESTful Web Services Cookbook разделе 5.4:

Ссылки типа отношения транспортирует роль или назначение ссылки. Как только клиенты и серверы согласятся о значении этих типов, клиенты могут находить и использовать URI из ссылок.

Например, edit является standard link relation, который имеет explicit details включая детали вокруг использованием GET, PUT, POST, DELETE.

Связи могут быть расширены и вы можете добавить свои собственные.