При построении RESTful/API гипермедиа с ресурсами JSON кажется, что у меня есть два варианта указания отношений гипермедиа между ресурсами.
Вставьте ссылки в тело документа JSON. Проблема здесь в том, что не существует стандартизированного синтаксиса для указания гиперссылок, хотя я вижу ряд хороших попыток: (HAL, Collection+JSON, JSON-LD, JSON Schema и многие другие).
Используйте заголовки ссылок HTTP. Это стандартизировано, так что у него есть преимущество перед встроенными ссылками. Клиенты просто понимают, как разобраться в стандартном заголовке, и вуаля, совершенство гипермедиа достигнуто.
Итак, конкретно в контексте обработки ресурсов JSON, что следует делать и почему?