json - 多态类型的 Json 对象建模

Question

我正在构建一个接受形状 Json 的 REST API。此 API 根据形状类型和参数计算面积。

在以下两种方式之间，哪一种是更好的对请求 json 进行建模的方式？

选项1

{
    "shape": {
        "type": "RECTANGLE",
        "value": {
            "length": "x",
            "breadth": "y"
        }
    }
}

选项 2

{
    "shape": {
        "type": "RECTANGLE",
        "length": "x",
        "breadth": "y"
    }
}

在我的选择

选项1

• 形状类型和值之间的良好隔离。但除了请求 Json 的可读性之外，我不确定这是否是一个巨大的好处。

选项 - 2

• 比选项 1 更轻；较小的字段作为值没有明确提及。

两种选择之间的优缺点是什么？

谢谢，帕万

标签： jsonrestapi-design