我们有以下令牌模式,而scmOrg被定义为外键。
{
id integer($int64)
scmOrg ScmOrg{...}
type string
rawToken string
}
打开Swagger控制台时,它会构建如下示例输入:
{
"id": 0,
"scmOrg": {
"id": 0,
"scm": {
"id": 0,
"name": "string",
"baseUrl": "string",
"clientId": "string",
"clientSecret": "string"
},
"name": "string",
"team": "string"
},
"type": "string",
"rawToken": "string"
}
只能为现有的scmOrg实体添加一个新的令牌,因此我真正想要的是这样一个更简单的东西:
{
"id": 0,
"scmOrg": {
"id": 0
},
"type": "string",
"rawToken": "string"
}
有可能大摇大摆吗?
AFAIK没有办法实现这一点。事实上,您可以编辑您的模型来设置@ApiModelProperty(隐藏=true)
。但是,我反对这样做,此外,无论你在模型上做什么,下次重新生成时都会被覆盖。看看这个链接,它有点旧,但似乎昂首阔步背后的人似乎没有这个在他们的路线图中。https://community.smartbear.com/t5/Swagger-Open-Source-Tools/How-to-hide-Model-Information/m-p/183188#M347
我试图在我的微服务项目中生成一个单独的招摇过市,在Api网关中将所有服务招摇过市聚合成一个单独的招摇过市。为了实现这一点,我将遵循下一个教程https://objectpartners.com/2017/09/28/aggregate-services-into-a-single-swagger 这里的问题是,当我尝试设置绝对URL时,我收到的输出是未能加载API定义。未定义的http://loc
我的pom.xml 招摇过市配置 服务器日志 它说映射: 但这些都不起作用(404): 如果我使用sping-fox较低版本,那么我将在我的日志中得到它已映射{[/v2/api-docs}],方法=[GET]。但是,我看不到在那里生成的任何json。
我正在努力理解如何为API网关使用Swagger扩展: http://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html 我正在通过AWS CLI使用导入/导出RestAPI,但在命令行中找不到如何使用它们的任何示例。你能帮忙吗? 谢谢
我试图在我们现有的JAX-RS REST项目中设置Swagger来记录我们的API。 对于接收JSON请求体的操作,我们一直使用以下习惯用法: 通过获取映射,JAX-RS将JSON对象映射到映射中,以按键名访问值。这样做很好,避免了每次这样的操作都需要一个模型。 但是,Swagger会扫描这些操作,并自动将Map作为请求参数。我的意图是,我在@ApiInverityParams注释中正确定义参数。
我试图通过Swagger UI记录在供应商产品(WSO2 ESB)中开发的现有API服务,以供公司内部使用。供应商产品不支持招摇过市。我计划以编程方式检查/处理API服务的源代码(编写在供应商产品中),并在中生成一个包含swagger定义文件的目录/文件夹/库。json或。yml格式。那很好,我能做到。 这些api定义文件中的每一个都将在swagger UI中很好地呈现,我正在考虑使用https: