腾讯云
开发者社区
文档
建议反馈
控制台
登录/注册
首页
学习
活动
专区
圈层
工具
MCP广场
文章/答案/技术大牛
搜索
搜索
关闭
发布
文章
问答
(4150)
视频
沙龙
1
回答
如何
比较
两个
OpenAPI
/
Swagger
json
API
文档
之间
的
路径
、
定义
、
参数
和
响应
?
、
、
、
、
我想知道是否有解决方案可以帮助找出同一产品(
Swagger
/Open
API
2.0)
的
两个
不同
API
版本
之间
的
差异。例如,这个工具:
比较
参数
、
响应
、注释、http方法(GET、POST、PUT、DELETE…),但不
比较
定义
,这是我目前需要
的
主要功能。 提前感谢!
浏览 13
提问于2018-09-03
得票数 1
2
回答
OpenAPI
对“傲慢”
、
、
使用
OpenApi
的
实际优势是什么? 我是
openApi
技术
的
新手,我只是想知道在
openApi
中有哪些特性比在
swagger
中有更多
的
特性。网上文件帮不了我。有人能帮我吗。
浏览 2
提问于2020-04-03
得票数 9
回答已采纳
2
回答
Swagger
;根据可选
参数
指定
两个
具有相同代码
的
响应
、
、
这个问题不是()
的
重复,因为该OP试图返回200或400。GET /endpoint -> {200, schema_1}在yaml中,我尝试有
两个
200代码,但查看器将它们压缩,就像我只指定了
浏览 0
提问于2016-04-12
得票数 46
回答已采纳
1
回答
Swagger
openapi
3.0.x空体
、
、
、
我正在尝试为我
的
express
api
从
swagger
2.0迁移到
openapi
3.0.2。
swagger
定义
和
路径
是用
swagger
-jsdoc编写
的
。这应该不会造成任何问题,因为他们
的
文档
指出,它可以与
openapi
3.x以及
swagger
2.0一起工作。将
openapi
: 3.0.x添加到我
的
sw
浏览 23
提问于2019-10-31
得票数 2
回答已采纳
1
回答
Swashbuckle:带有查询
参数
的
POST
API
端点
、
、
、
、
我需要帮助覆盖
swagger
生成器来处理
API
端点,并将查询
参数
记录在swashbuckle中。 POST /
api
/cu
浏览 2
提问于2019-01-11
得票数 0
2
回答
Django Rest Framework自
定义
POST URL端点,带有
定义
参数
(request.POST),包含
Swagger
或其他
文档
、
、
、
、
在上述特殊情况下,接受一个
参数
的
是POST
API
"test_token“。并生成
API
文档
,如
swagger
/redoc (可用于测试
API
)注意事项: 在此还指出,django rest-
swagger
在2019年6月被否决。(如标题所示: Django Rest Framework自
定义
POST URL端点,带有
Swagger
或其他
文档
的
浏览 29
提问于2021-01-27
得票数 12
回答已采纳
1
回答
在
API
管理前端保存
Swagger
文档
时缺少架构
、
、
,但由于“
路径
”下
的
“
响应
”字段中缺少$ref,所以它也没有显示。虽然我也尝试输入
OpenAPI
3.0
文档
,但我在正式
文档
之后重写了
文档
,我还检查了
API
3.0对
OpenAPI
3.0
的
支持情况,显然,它在预览特性下是支持
的
。我已经检查过在
OpenAPI
3.0中不再有'
swagger
‘字段了,取而代之
的
是'
open
浏览 0
提问于2019-09-03
得票数 3
1
回答
Ocelot MMLib.SwaggerForOcelot显示“没有在规范中
定义
的
操作!”
、
、
、
我使用
的
是Ocelot网关
和
使用"MMLib.SwaggerForOcelot“库
的
swagger
文档
。对于某些
swagger
键,
swagger
显示“没有在规范中
定义
的
操作!”傲慢
的
JSON
将无路可走,就像 "
openapi
": "3.0.1", "title&q
浏览 25
提问于2022-05-20
得票数 1
回答已采纳
1
回答
在RouteTemplate配置中{documentname}
的
用途是什么?
、
、
默认情况下,/
swagger
.
json
将在以下路由“/
Swagger
/{ }/
swagger
.
json
”公开。如果有必要,您可以在启用
Swagger
中间件时对此进行更改。自
定义
路由必须包括{documentName}
参数
。 { c.RouteTemplate = "
api
-do
浏览 4
提问于2020-09-18
得票数 8
回答已采纳
4
回答
在多个文件中拆分
swagger
定义
、
、
、
、
问:,我
如何
在文件
之间
分割傲慢
的
定义
?在这方面有哪些可能性?include samples/settings.
json
最后两行在这里很重要--使用!换句话说,通过这种方式,我可以在
两个
契约(这里是RAML)
和
其他工具(非RAML,non,只是基于just模式
的
工具)中重用模式文件。这是整个规范所支持
的</em
浏览 16
提问于2016-02-22
得票数 5
5
回答
Swagger
2.0-
如何
使“一个或另一个”
参数
需要?
下面
定义
了一个
swagger
2.0资源。
如何
使"param1或param2“成为必需
的
?调用者必须传递param1或param2。
浏览 3
提问于2015-04-17
得票数 79
回答已采纳
1
回答
swagger
API
文档
和我自己
的
yaml文件
、
我用
Swagger
记录了我
的
API
。为了方便开发人员,我也想在我
的
网站上提供
swagger
GUI。但是,我
的
供应商还没有安装php yaml扩展。这意味着我不能在我自己
的
网站上使用GUI。我知道我可以使用并在文本框中输入我
的
yaml文件
的
链接。这也不是真正
的
用户友好。我更喜欢在调用url时打开GUI并指定yaml。对于用户,GUI将打开我
的
API
定义
。 有什么想
浏览 0
提问于2020-12-29
得票数 1
1
回答
验证
OpenAPI
是否符合REST设计最佳实践
、
、
我们正在使用
Swagger
从源代码中生成
API
文档
。我现在想知道是否有任何工具可以自动检查生成
的
OpenAPI
文档
(=
Swagger
)与RESTful
API
设计最佳实践
的
一致性。例如,Zalando为REST设计
定义
了一个可公开使用
的
指南,在这些指南中,有许多规则可以根据
OpenAPI
规范自动检查: 当
比较
不同版本
的
OpenAP
浏览 0
提问于2017-09-29
得票数 4
2
回答
Swagger
码元生成重复变量。
、
、
、
、
Should be set to application/
json
name: Content-Type requiredShould be set to application/
json
<plugin> <groupId>io.
swagger
.
浏览 3
提问于2020-03-03
得票数 2
回答已采纳
4
回答
如何
在
OpenAPI
中
定义
全局
参数
?
、
我正在准备我
的
API
文档
,它是手工编写
的
,而不是自动生成
的
。我有应该发送给所有
API
的
报头,但不知道是否可以为整个
API
全局
定义
参数
?这些头文件有些是静态
的
,有些是在调用
API
时设置
的
,但它们在所有
API
中都是一样
的
,我不想为每个
API
和
每个方法复制
和
粘贴
参数</em
浏览 1
提问于2013-10-25
得票数 28
回答已采纳
2
回答
JSON
模式与Open Java支持
、
、
、
、
我在这里遇到了这个
JSON
模式规范。 假设您有一个需要使用
的
API
(
浏览 5
提问于2022-02-08
得票数 3
2
回答
如何
从现有的Spring生成
OpenAPI
3.0 YAML文件?
、
、
、
、
我有一个现有的Spring,我想为它生成
OpenAPI
3.0 YAML文件,而不是
Swagger
2.0
JSON
/YAML?此外,还有,但它似乎不支持Spring。/"
openapi
浏览 0
提问于2019-02-28
得票数 26
回答已采纳
1
回答
是否有任何工具同时提供gRPC
和
OpenAPI
文档
生成功能?
、
、
这些文件包含rpc
定义
(包含所有必需
的
请求/
响应
主体),以及google.
api
.http选项,该选项允许创建http代理,以便客户端可以使用gRPC或
json
/http进行调用。第二个最好
的
方法是采用proto
和
swagger
文件来以统一
的
方式创建
文档
。 有很多工具只创建
OpenAPI
文档
,我发现一些工具是
和
。这些文件基于
swagg
浏览 1
提问于2021-10-26
得票数 2
2
回答
从gin项目生成
OpenAPI
规范
、
、
、
有办法从gin项目生成
OpenAPI
规范文件吗?这个问题真的很难找到,到目前为止,我所能找到
的
都是做反向
的
。
浏览 9
提问于2022-05-23
得票数 4
点击加载更多
热门
标签
更多标签
云服务器
ICP备案
云直播
腾讯会议
实时音视频
活动推荐
运营活动
广告
关闭
领券