我正在记录一个使用Swagger 2.0的REST API (在Go中开发)，API响应使用的一个结构包括几个在Go中声明为"Json.RawMessage“类型的字段。我在Swagger规范中找不到任何合适的“数据类型”来涵盖这一点。我能想到的最接近的情况是一个"byte“格式的字符串。但这还差得远呢。任何想法都会有很大的帮助。
浏览 12提问于2019-12-09得票数 1
我正试图为我的api创建一个昂首阔步的文档，我有点被困在了一些我认为一旦您知道如何实现就很容易实现的东西上了。所以这个结构是这样的：carAge:20我的问题是，我不知道如何在“carParts”文档中表达这一点如果没有，我想唯一的选择是更改我的api，将"carParts“项作为一个平面列表，而不是一个结构(即失去"carParts”父级，并使这些项只是其他顶级的表单数据项)
浏览 2提问于2017-08-10得票数 2
回答已采纳
我试图使用Swagger来定义接受实际文件的API和描述文件内容的模式对象。这是“摇摆YAML”的一个片段。但是，它不会在Swagger中验证。/document: summary: Api Summary consumes: required: trueSwagge
浏览 6提问于2015-09-22得票数 7
description": "", "type": [null,"file"]但是我没有办法告诉aspnet核心mvc或swaggerGen我希望swaggerUI包括选择一个文件或发布一些json数据的选项。这能办到吗？
浏览 2提问于2017-08-04得票数 1
回答已采纳
我试图为这个OpenAPI请求创建一个multipart/form-data定义： http://localhost:1234/api/v1/Submit \post: - multipart/form-data - application/json typ
浏览 3提问于2018-04-17得票数 5
回答已采纳
我希望在OpenAPI中表示以下JSON对象： "name": "Bob", ...属性的数量和属性名称还没有完全预先确定，所以我希望使用additionalProperties但是，我不太确定它将如何通过OpenAPI/Swagger2.0来表示。我试过这个： type: object
additionalPrope
浏览 2提问于2017-09-28得票数 11
回答已采纳
1回答
我正在将我的应用编程接口从Swagger2.0迁移到OpenAPI 3.0。在DTO中，我有一个指定为字节数组的字段。在将API定义转换为OpenAPI之后，该对象的定义保持不变，但是openapi代码生成器现在需要org.springframework.core.io.Resource而不是byte[] (new Job在我的代码中，有一些地方我必须序列化作业对象，但现在不可能了，因为Resour
浏览 62提问于2020-07-08得票数 10
回答已采纳
我正在使用Swagger Editor编写API文档，但在包含JSON对象的多部分POST请求中遇到问题。这是我的Swagger YAML文件：info: title: Documentation API /agent:201: 400:
description: invalid i
浏览 5提问于2017-06-02得票数 4
我正在为现有的应用程序接口编写一个OpenAPI规范。此接口返回成功和失败的状态200，但响应结构不同。例如，在注册API中，如果用户注册成功，API会发送状态200，其中包含以下JSON： "result": true,}{
"result": fa
浏览 0提问于2017-11-23得票数 21
回答已采纳
2回答
使用OpenApi的实际优势是什么？
我是openApi技术的新手，我只是想知道在openApi中有哪些特性比在swagger中有更多的特性。网上文件帮不了我。有人能帮我吗。
浏览 2提问于2020-04-03得票数 9
回答已采纳
因此，我有一个API调用，它是一个查询，即它不做任何更改，也不创建任何东西(幂等和安全)。但是它需要传入一个复杂的JSON参数(条目列表、2或3组地址等等)。因此，我正在使用URL编码的JSON参数做GET。这似乎是正确的方法。我看到很多自命不凡的API.我不知道是否有方法使用Swagger使用JSON参数执行适当的r
浏览 5提问于2016-01-15得票数 8
我的自以为是的定义是： type: object enable: default: false type: array items: ip: default: ''
浏览 1提问于2019-07-15得票数 4
回答已采纳
我有一个REST API，它有两个参数，如下图所示： ? 如您所见，这是表单数据参数。 如何将其添加到API管理器？
浏览 13提问于2021-07-25得票数 0
回答已采纳
1回答
operationId: "countCards" - "application/json" - name:description: "Input is optional - left blank will return all tags and a count" fo
浏览 2提问于2017-08-11得票数 0
回答已采纳
5回答
为什么区分器属性会被序列化两次？
、、、、
我在组件模式中使用Java3.0继承，我有OpenAPI生成器(使用openapi)生成的类。
为什么判别器属性在结果JSON中被序列化两次？这是一个Java优先项目，它应该使用openapi生成器来生成JHipster模型(POJO带有JHipster注释)和API控制器(与Spring@Api注释的接口)。通过遵循OpenAPI 3.x文档/示例，似
浏览 3提问于2019-08-29得票数 5
1回答
我希望将其作为自动构建(最好使用Gradle)的一部分来完成，这样我就可以创建服务接口，并将接口的实现作为自动化过程的一部分。这个工作示例展示了如何做到这一点，但是它使用了Swagger2.0规范YAML：错误是：
在[来源：(字符串)“openapi: 3.0.0 ]处读取com.fasterxml.jackson.core.JsonParseException:未识别的令牌'<
浏览 6提问于2020-01-23得票数 10
回答已采纳
我想创建一个具有openAPI规范的JSON。api/endpoint的有效载荷格式如下所示，这是openapi JSON格式， "openapi": "3.0.0",: { "putSc
浏览 1提问于2022-09-28得票数 1
回答已采纳
我想用策略验证API中的JSON请求-Body。可空:真 </validate-content>
浏览 2提问于2021-05-20得票数 0
回答已采纳
我正在开发一个旧的web服务，在该服务中，我使用自定义工具生成符合美洲国家组织标准的其他端点文档。使用这个美洲国家组织的json文件，我可以通过门户将API部署到Azure管理服务中，这一切都很好。但是，我需要自动化这个过程，因此需要使用ARM模板将所有web服务部署到Azure APIM。我一直在研究提供的示例，但似乎无法理解如何在github中使用本地OAS.json文件<em
浏览 0提问于2018-08-27得票数 0
回答已采纳
云服务器
ICP备案
腾讯会议
云直播
对象存储
腾讯云开发者
