Swagger - 具有未知键的键值对数组

Question

我正在尝试编写Swagger API文档，但我遇到了一个特定情况的问题。

我有一个巨大的网格，每个都有id引用（想象棋盘），我想发送已更改的网格引用和每个中的新ID。所以我可能有一个40x40网格，我将其中一个网格方块更改为不同的值。

我想发送到我的API：

12x21 = 12345
23x11 = 87654
42x01 = 12987
23x09 = 19283

无需将swagger中的每个网格位置列为参数，如何使用Swagger UI表示此场景？

Answer 1

我会设计一个端点，您将更改发送到PUT请求（如果是新ID，则为POST请求，从上下文中很难判断），实际更改为JSON你的要求的身体。然后，对网格的引用可以作为查询参数发送，也可以作为JSON正文的一部分发送。