假设我有一个 REST 服务,它可以接受请求正文中的任意 JSON。我如何使用 swagger-spec 对此进行建模?
我想过Model Objects ,但我只能想到将任意 JSON(作为字符串)包装在容器 JSON 对象中,例如 {"payload": "{ some JSON object serialized to a string }"}
,这不是很有用。
或者,是否有其他方式来表示端点可以在请求正文中接收任意 JSON?
最佳答案
Swagger 在 API 方面试图确定性,因此不直接支持您所要求的内容。
我能想到的唯一方法是将“consumes”属性设置为“application/json”并添加一个字符串类型的“body”参数。这在理论上说应该只发送 JSON,但实际上,可以发送任何字符串。
此外,如果在将字符串发送到服务器之前尝试将字符串转换为 JSON 对象,这可能会破坏某些第三方工具。
关于json - 如何在 swagger-spec 中表达 "arbitrary JSON"?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/25296967/