-
2 votesanswersviews
需要授权Swagger文档
我正在使用 grape ， grape-swagger 和 grape-swagger-rails 为我的Rails 4.2.1项目设置API . 它是最好的方法吗？ 我最初的想法是利用您可以在 swagger-ui 中设置的 api_key 字段，但我无法找到在Grape的根API生成器中访问它的正确方法 . 如果用户是管理员，我还以为我可以尝试只安装文档的 endpoints （我们自己隐藏文... -
2 votesanswersviews
Swashbuckle Bearer授权
我有一个ASP.Net应用程序，它使用Swashbuckle并查看文档都工作正常，直到另一个开发人员使用JWT设置一些授权逻辑，并且需要在每个头请求中传递“授权承载” . 在实现之后，我甚至无法查看/ 44300 / swagger中的文档 . 它只是说无效的凭据 . 我有能力生成一个令牌命中/ api /安全 endpoints 但是如何配置Swashbuckle来获取/使用令牌只是为了加载文档... -
2 votesanswersviews
swagger-codegen文件位置
我在一个项目上玩swagger-codegen，我最后问自己一个问题：swagger文件的位置是否有任何约定？ 这是我的情况：我正在为我的项目使用Maven，所以我有标准的Maven结构： pom.xml src |--main |--java |--resources |--webapp |--test |--java |--resources 要使用Swagge... -
1 votesanswersviews
如果在耳模块中使用，Swagger不会识别@Api注释，但在战争中部署了swagger
我们正在使用Wildlfy 10和Swagger 1.5.12（Swagger 2.0规范）在我们的应用程序中，我们正在部署 Contract 并实现我们的Web服务，以确保能够在此级别上交换实现 . 暴露我们的网络服务的战争被打包在同一个耳朵里，可以访问它的所有模块 . swagger定义放在war文件中 . 虽然webservice endpoints 按预期工作，但swagger.json仅... -
0 votesanswersviews
测试没有Swagger的 endpoints
我正在为我的公司开发一个软件包来管理这个独特的Web应用程序上的所有活动 . 我使用Spring API REST技术作为后端，使用React.js作为前端 . 用于部署微服务的Docker和用于API文档的Swagger . 我在所有这些之后设置了身份验证块，我选择了MITREid Connect，它是OpenID和OAuth 2.0的一个实现，但由于插入了这三块砖，我无法再对Swagger进行... -
1 votesanswersviews
用于测试目的的动态控制的swagger模拟服务器
我正在寻找能够获得swagger specs文件作为参数的项目/工具，并生成可以通过REST API接口以编程方式控制的模拟服务器 . 例如 - 如果我的API包含以下 endpoints ：“POST / v1 / create”并且我有一个描述该API的swagger规范，我希望我的模拟服务器以类似于以下的方式执行： mock-server -f swagger.yaml -p 8080 当服... -
0 votesanswersviews
SignalR面向公众的API
在我正在开展的项目中，我们正在开发面向公众的API，以便第三方通过我们的解决方案进行集成 . 我们需要实现“实时更改通知”，这意味着服务器需要注意客户端某些资源已更改 . API将由专有应用程序，移动应用程序和Web应用程序使用，因此该技术的一般易用性非常重要 . 我正在考虑多种技术，如网络套接字，SSE，长轮询和SignalR . 由于我之前曾与SignalR合作过，而且作为后端开发人员使用它很... -
1 votesanswersviews
没有带Swagger UI的web.xml的Apache CXF
我在没有web.xml的情况下使用CXF进行RESTful Web服务 . 所有CXF和rest endpoints 配置都存储在xml文件中（由Spring管理） . 现在我正在尝试在我的服务中实现Swagger . 我在我的jax-rs配置中添加了SwaggerFeature： <jaxrs:features> <ref bean="swaggerFe... -
0 votesanswersviews
Swagger UI和CXF规范中没有定义任何操作
我正在使用Apache CXF构建Spring Boot应用程序 . 在尝试添加招摇时，我得到规范中没有定义的操作！错误，虽然我通过注释1-2操作指定 . Swagger的CXF配置部分如下： factory.setFeatures(Collections.singletonList(createSwaggerFeature())); public Swagger2Feature create... -
23 votesanswersviews
如何为swagger REST API文档生成Java客户端代码
我的方案如下 . 我有一个招摇.json例如：http://petstore.swagger.io/v2/swagger.json我想为上面的REST API使用生成的java客户端，例如： PetApi petApi = new PetApi(); Pet pet = new Pet; pet.setName("cica"); pet.setId(1L); petApi.ad... -
0 votesanswersviews
如何编写在请求体中接受XML的swagger API
我们使用Swagger编写REST API . 我们有一个POST服务，它应该接受请求体中的XML文件 . 这是我们的请求定义： /services/invoke: post: tags: - invoke summary: A request invocation operationId: invokeUsingPOST c... -
1 votesanswersviews
关于Swagger API的建议
我正在使用Java 8使用SpringBoot和Spring REST服务构建API . 我刚刚发现了Swagger API，现在我想使我的API Swagger兼容 . 到目前为止，我读到，Swagger是一个记录您的APIS的工具，但也提供了从规范生成客户端和服务器代码的功能（v2中的swagger.json），以及与您的API交互的漂亮的Web界面 . 现在，我想了解一些关于如何继续的建议，... -
5 votesanswersviews
在Angular2中使用生成的Swagger TypeScript Rest Client
我正在使用Angular 2和TypeScript处理Meteor Web应用程序 . 对于使用REST API，我使用Swagger Codegen生成了客户端代码 . 不幸的是GitHub上没有样本，如何使用其余的客户端 . 我有一个角度2视图组件，它注入一个Angular 2服务（ProductTreeService）和生成的API（都标记为“@Injectable”）： @Componen... -
6 votesanswersviews
如何正确使用swagger规范生成的服务器存根？
我使用Swagger 2.0和swagger-codegen（实际上是Maven的swagger-codegen-plugin）来指定，记录和生成API，以Java作为目标语言 . 该项目已经设置为构建服务器存根（JAX-RS）和文档，Eclipse识别项目buildPath中生成的代码 . 我不确定这里适当的工作流程是什么 . ： - / 我不认为我应该修改生成的类，否则每当我更改swagg... -
0 votesanswersviews
使用springfox，swagger和gradle生成静态文档[重复]
这个问题在这里已有答案： How to generate swagger.json using gradle? 2个答案 我已经在一个简单的Spring Boot应用程序中评估了 springfox 的集成，暴露了一些REST API . 乍看之下一切正常 - 当应用程序启动时，我可以在JSON endpoints 看到Swagger规范，我可以连接并使用Swagger UI，Swagger注... -
0 votesanswersviews
除非使用editor.swagger.io，否则Swagger JaxRS-Spec生成在简单类型上失败
我遇到了Swagger YAML和代码生成的问题 . 我试图从这个非常简单的代码片段生成代码： swagger: '2.0' info: version: 1.0.0 title: Number API host: localhost basePath: /v2 schemes: - http paths: '/numbers': get: summary: Get... -
4 votesanswersviews
Swagger / OpenAPI：如何在构建过程中集成typescript / angular客户端的生成？
Java/Spring Server-Stubs Generation with swagger-codegen-maven-plugin 在我的Spring Boot Java项目中，我使用swagger-codegen-maven-plugin从我的Swagger 2.0 api.yml生成Spring MVC控制器接口（服务器存根） . maven构建过程中的集成非常简单 . 它像我以前用... -
2 votesanswersviews
swagger-editor vs swagger-codegen
我是一个招摇的新手，我一直在尝试用swagger编辑开发api . Swagger-codegen声明这是一个开源代码生成器，可直接从Swagger定义的RESTful API构建服务器存根和客户端SDK . 当我使用swagger-editor时，我可以看到选项：生成服务器和生成客户端（我在本地运行swagger-editor） swagger-codegen是否具有与swagger-edito... -
0 votesanswersviews
无法将Bing Maps API与Power Apps连接
我们需要将Bing Map 添加到Power Apps中的某个应用中 . 每当我们在Power Apps http://dev.virtualearth.net/REST/v1/Imagery/Map/imagerySet/centerPoint/zoomLevel?mapSize=mapSize&pushpin=pushpin&mapLayer=mapLayer&form... -
5 votesanswersviews
无法从Swagger Jersey获得json
我有基于Jersey 1.18.1的RESTful服务，我想通过Swagger显示我的API .首先，我必须得到JSON . 我读了这条指令：Swagger Core Jersey 1.X Project Setup 1.5 . Swagger允许设置不同的配置方法，我决定使用自定义的Application子类 . 我一步一步地做了所有事情，但我无法获得我必须用于swagger-ui的JSON ... -
16 votesanswersviews
如何生成swagger.json
我使用java spring boot框架为我的项目创建REST api，我使用"springfox-swagger2 and springfox-swagger-ui"生成swagger文档 . 我可以使用url http://localhost:8080/swagger-ui.html查看我的文档 . How can I crate or generate swagger.... -
0 votesanswersviews
Swagger Editor生成了python-flask null类型错误
我在Swagger hub / Swagger编辑器上创建了我的rest-ful api endpoints 文档 . 我有基于python-sanic的restful api endpoints . 我生成并运行python-flask服务器，但收到错误消息 . 未捕获的TypeError：Swagger 2.0不支持空类型（[object Object]） . 我已经调查了这个问题，但... -
0 votesanswersviews
Swagger和web.xml
我正试图使用我的java rest api进行招摇 . 我跟着swagger documentation . 但是，我无法大摇大摆地工作 . 例如，根据文档，我应该从swagger获得一个json文件 - 但无论我尝试什么URL，我都没有得到它 . <context-param> <param-name>resteasy.providers</param-na... -
1 votesanswersviews
使用CXF中的swagger生成脱机文档
我正在尝试使用带有cxf和camel的swagger生成REST文档 . 我已经成功获得了昂首阔步的文档 . 而且我的心烦意乱！ 所以现在我正在尝试导出所有内容并构建离线文档 . 为了做到这一点，我使用：1）swagger-maven-plugin：REST - > json 2）swagger2markup-maven-plugin：json - > asciidoc 我设法得到... -
6 votesanswersviews
生成swigger的cURL命令
我们有一个由swagger running here生成的API文档，我问自己如何让swagger为当前 endpoints /方法生成一个额外的curl命令行示例 . 这可能没有黑客入侵skala吗？ -
34 votesanswersviews
Swagger可以根据现有的快速路线自动生成其yaml吗？
我继承了现有的API，我想用swagger记录它，但我还不知道它的全部范围 . Swagger（或其他中间件/工具）可以根据现有的快速路线自动神奇地生成yaml（用于招摇）吗？ 对于我在其他问题上看到的情况，似乎这主要是一个手工工作，但我仔细检查是否有人在这里找到了办法 . -
2 votesanswersviews
我可以从现有的Java代码中获取Swagger文档吗？
在 Swagger 我绝对是新的，我有以下疑问： 我知道通常我必须在代码我的REST API之前创建Swagger文档并使用此文档来创建我的API（我知道从Swagger编辑器我也可以自动生成我的API服务器） . 我的问题是以下一个： 我正在开发一个实现我的REST API的Java应用程序（Spring Boot应用程序） . 我想使用Swagger来创建我的API文档 . 有办法自动完成吗？... -
1 votesanswersviews
使用Spring REST Docs生成Swagger客户端
我见过这个Spring REST Docs - video 我们正在进行Spring启动项目，并使用springfox库生成Swagger-ui和swagger文档，如here所述 我们喜欢Spring Rest文档可以用来生成REST API文档，以及我们不需要在我们的Controller代码中添加像@ApiResponse或@ApiOperation这样的swagger注释 . 此外，文档... -
0 votesanswersviews
AWS API的Swagger / Postman集合？ [关闭]
我想使用像postman这样的工具来针对各种AWS服务调用REST API . 但是，我似乎无法找到预构建的Postman集合甚至是AWS API的Swagger定义 . 我显然可以手工处理每个请求，但有没有人知道是否有更简单的方法？ （比如通过内省SDK或某些东西来生成Swagger？） -
1 votesanswersviews
为现有NodeJS服务器生成Swagger文档
我花了很多时间，然后我看到了这个question on SO，最后一个答案是express-oas-generator似乎是一个很好的工具 . 成功生成了我的文档，但 POST 没有制作我的Payload文档，没有这个，一些开发人员可能认为我的 POST 不需要有效负载发送 我所做的就是遵循文档，使用API进行一些测试并使用POSTMAN调用方法 . express-oas-generator生...