Как должна быть предоставлена ​​ссылка на схему клиенту для конечной точки массива гипермедиа/успокоительного json

У меня есть служба гипермедиа/отдыха, которая предоставляет коллекции как конечные точки (доступные для страниц). они сериализуются как массивы json.

у меня есть (автоматически сгенерированная) схема json для каждой конечной точки, и я хочу сообщить расположение этих схем клиенту, но поскольку конечные точки представляют собой массивы json, я не могу включить свойство «$ schema», которое содержит ссылку на соответствующий схема.

есть несколько вариантов, которые я могу придумать:

  1. оберните массив в объект json, который содержит массив json вместе со ссылкой на схему (и любые другие свойства, характерные для коллекции)

  2. укажите ссылку на схему в качестве пользовательского параметра заголовка http

  3. предположим, что клиент просто «знает», как получить схему для конечной точки, без явного указания

  4. предоставить клиенту общий формат URL-адреса схемы на корневом уровне, который клиент затем запоминает и использует для создания всех ссылок схемы самостоятельно

Каков наилучший способ предоставить клиенту ссылки на схему json?


person fusi    schedule 07.01.2016    source источник


Ответы (1)


основная спецификация схемы json рекомендует использовать "Content- Заголовки Type" или "Link", так что пока я буду использовать их.

person fusi    schedule 07.01.2016