Swagger 招摇过市:不允许在POST方法上查询参数?
我在Swagger中描述了一个POST端点,我希望该端点也有查询参数。我们使用1.2的招摇过市格式是因为,好吧,传统的原因。我们使用3scale,它承载文档,您可以在其web UI中编辑您的炫耀。但是,当我试图保存文档时,它会给我以下错误Swagger 招摇过市:不允许在POST方法上查询参数?,swagger,3scale,Swagger,3scale,我在Swagger中描述了一个POST端点,我希望该端点也有查询参数。我们使用1.2的招摇过市格式是因为,好吧,传统的原因。我们使用3scale,它承载文档,您可以在其web UI中编辑您的炫耀。但是,当我试图保存文档时,它会给我以下错误 JSON规范不能在同一方法上使用paramType='body'和paramType='query' 我在招摇过市的说明书中找不到任何说明这是实际限制的东西。这可能是3Scale特有的,还是一个普遍的招摇限制?如果是后者,有人能告诉我一个规范吗 实际的REST
JSON规范不能在同一方法上使用paramType='body'和paramType='query'
我在招摇过市的说明书中找不到任何说明这是实际限制的东西。这可能是3Scale特有的,还是一个普遍的招摇限制?如果是后者,有人能告诉我一个规范吗
实际的REST端点并不关心,它对帖子上的查询参数很满意。这只是为了让招摇过市的工具变得快乐。以下是《大摇大摆》的简短片段:
{
"parameters": [
{
"name": "myQueryParam",
"dataType": "string",
"paramType": "query",
"required": true
},
{
"name": "body",
"dataType": "string",
"paramType": "body",
"required": true
}
],
"httpMethod": "POST"
}
不确定错误消息是否为一般验证错误,但在您共享的规范中有几个错误:
- 它是“方法”,而不是“httpMethod”
- 它是“类型”而不是“数据类型”
据我所知,这只是一个自大规格方面的限制。它们还限制在GET方法中传递请求体。我不认为有这样的限制有什么意义,因为用例各不相同,而且可能不足以将所需的参数作为查询参数发送,特别是由于它的大小限制。