У меня есть много мест в моем API, где мне нужно будет описать список объектов.Каждый объект имеет одинаковые ключи / структуру, но разные значения.Как я могу настроить значения каждого экземпляра некоторой структуры данных, сохранив при этом весь исходный тип, описание и т. Д. Исходной структуры?
например, если у меня была следующая структура данных Restaurant
# Data Structures
## Restaurant (object)
+ restaurant_name: McDonald's (string, required) - The name of this restaurant
+ years_of_operation: 54 (number, required) - The number of years since established
Тогда, скажем, я хочу создать несколько Restaurant
s в ответе GET, например:
### List all restaurants [GET /restaurants]
+ Response 200 (application/json)
+ Attributes
+ data (array)
+ (Restaurant)
+ (Restaurant)
+ restaurant_name: Bob Evans
+ years_of_operation: 23
+ (Restaurant)
+ restaurant_name: Eataly
+ years_of_operation: 16
тело JSON будет выглядеть следующим образом (обратите внимание, как years_of_operation
для Боба Эвансаи Eatly теперь являются числами)
, и предоставленная документация покажет это только (описания для restaurant_name
и years_of_operation
для Боба Эванса и Eatly теперь отсутствуют)
Я думал, что MSON перенесет эти описания и определения типов.В противном случае мне придется обновлять описание (или тип, требование и т. Д.) Везде, где используется структура данных ... но у меня сложилось впечатление, что это своего рода проблема, которую MSON должен решить?Я делаю что-то глупое?
Я публикую здесь в дополнение к моей проблеме с github , так как прошло много времени с того момента, как репо имело вклад