1

我的 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_operationBob Evans 和 Eatly 现在是数字)

图片

并且渲染的文档只会显示这一点(现在缺少 Bob Evans 和 Eatlyrestaurant_name的描述)years_of_operation

图片

我认为 MSON 会继承这些描述和类型定义。否则,我必须在使用数据结构的任何地方更新描述(或类型、要求等)......但我的印象是这是 MSON 应该解决的一种问题?我在做傻事吗?

除了我的github 问题之外,我还在这里发帖,因为该 repo 已经有很长时间没有贡献了

4

0 回答 0