我正在尝试创建一个适当的REST API,并使用Swagger(2.0)对其进行记录。
因此,我有一个作为查询的API调用,即它不做任何更改且不创建任何东西(幂等且安全)。但它需要传入一个复杂的JSON参数(项目列表,2或3组地址等)。因此,我正在使用带有URL编码JSON的参数进行GET。这似乎是正确的方法。
我经常看到这样的API,因此他们将其作为POST进行,但这是对POST动词的错误使用。
我看到很多的swagger API都可以做到这一点...
我不知道是否有一种方法可以使用JSON参数与Swagger一起使用适当的rest API。您当然可以将参数定义为字符串,然后将编码后的JSON传递给该字符串,但是swagger工具无法理解它是否具有架构/定义。
昂首阔步是否无法正确记录此类呼叫?