我的 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
在 GET 响应中实例化几个 s,如下所示:
### 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
Bob Evans 和 Eatly 现在是数字)
并且渲染的文档只会显示这一点(现在缺少 Bob Evans 和 Eatlyrestaurant_name
的描述)years_of_operation
我认为 MSON 会继承这些描述和类型定义。否则,我必须在使用数据结构的任何地方更新描述(或类型、要求等)......但我的印象是这是 MSON 应该解决的一种问题?我在做傻事吗?
除了我的github 问题之外,我还在这里发帖,因为该 repo 已经有很长时间没有贡献了