Повторное использование модели ресурсов в виде массива

Question

Я документирую API, и у меня есть 2 ответа, очень похожие.

Одним из них является вызов/ресурс/{id}. Этот ответ возвращает модель ресурса.

Другой вызов/resource/search {? Name, category}, который возвращает список ресурсов, поэтому мне нужно вернуть массив модели ресурса.

Я не могу найти, могу ли я это сделать. В документации по проекту есть что-то похожее о Гистах. Но есть две модели Gist and Gist Collection.

Надеюсь, я объяснил свое «я».

Answer 1

К сожалению, на данный момент вы не можете ссылаться на одну полезную нагрузку от другой. Причина этого в том, что полезная нагрузка (модель, запрос или ответ) непрозрачна для анализатора API Blueprint (и, следовательно, вам не нужно ничего скрывать внутри).

Планируется решить эту проблему и сделать чертежи более сухими в будущем - см. Контрольные точки и Traits.