swagger

问题 I'm making an application with express-serverless and I want to use swagger-jsdoc and swagger-ui-express during offline development. This is my configuration for swagger: const express = require('serverless-express/express'); const router = express.Router(); const options = { swaggerDefinition: { info: { title: 'REST - Swagger', version: '1.0.0', description: 'REST API with Swagger doc', contact: { email: 'me@someemail.com' } }, tags: [ { name: 'Stuff', description: 'Stuff API' } ], schemes:

问题 For prototyping we are using json-server library that creates fake REST api based on our db.json file. Now we would like to use swagger. So my question is, is there a way to generate swagger.json from our db.json file? If not, do you guys know some tool to generate swagger.json file easily? Thanks! 回答1: If you can make API calls to your 'fake' API, you can use Swagger Inspector to create an API Definition (swagger.json)! Steps: Go to https://inspector.swagger.io. You should create an account

问题 I need to generate classes based on provided swagger file. Unfortunately I have no influence on content of this file. My config in gladle looks like: task generateApi { doLast { def config = new CodegenConfigurator() config.setInputSpec("file:///$projectDir/$swaggerSourceFile") config.setOutputDir("$projectDir/$swaggerTargetFolder") config.setLang('spring') config.setAdditionalProperties([ 'interfaceOnly' : true, 'apiPackage' : 'somepackage', 'modelPackage' : 'somepackage.domain',

问题 I'm trying to find the .NET/C# solution for the conversion of swagger json specification to the static html file. I've found the alternatives for Java and Node.js: https://www.npmjs.com/package/bootprint-swagger (works completely as we need, but we can use node.js in our environment), https://github.com/swagger-api/swagger-codegen#generating-static-html-api-documentation, but nothing for .NET Probably you guys met or did something similar in .NET? Thanks in advance! 回答1: If you've the swagger

问题 I build a REST interface using Spring Boot framework. Then, I use Swagger version 2.9.2 to generate the documentation. As you can see from the photo below, Swagger automatically detects a lot of models. However, most of them are redundant. Among them, only the ResponseMessage is necessary, the rest are just standard Java class. So, my question is: how can I tell Swagger which models to expose ? Here are my Swagger configuration and code snippet of my controller. @Bean public Docket api() {

问题 I am using NSwag to generate swagger for my .NET Core api and everything works great, except the fact that paths are rendered in order that reflection seems to pickup Controllers from project. So if I do have hierarchy - some controllers at root level ( Controllers folder) and some in subfolder ( Controllers\Subfolder folder) then the order gets messed up. Is it possible to somehow tell NSwag to generate resulting swagger.json showing operations in alphabetical order? 回答1: There is option

问题 I was wondering is it possible to create a url-form-encoded post request within Swagger? For example: POST https://url.co.uk Host: server.example.com Authorization: Bearer <Initial Access Token> Content-Type: application/x-www-form-urlencoded &grant_type=password &client_id=<client id> &client_secret=<client secret> Currently we have the layout below for our various parameters but are not sure how to change to url-form-encoded. We have tried changing to in:body instead of header but this does

问题 I decided to make a micro-services gateway in Python's FastApi framework. My authorization service is written in Django and there are already generated by drf-yasg package swagger docs. I was thinking if there is a way to somehow import auth's schema to the gateway. I can serve the schema in json format via http and access it from the gateway. The question is how to integrate FastApi's docs with raw swagger schema file. 回答1: According to docs you can modify the openAPI json. Example: from

问题 I decided to make a micro-services gateway in Python's FastApi framework. My authorization service is written in Django and there are already generated by drf-yasg package swagger docs. I was thinking if there is a way to somehow import auth's schema to the gateway. I can serve the schema in json format via http and access it from the gateway. The question is how to integrate FastApi's docs with raw swagger schema file. 回答1: According to docs you can modify the openAPI json. Example: from

问题 I decided to make a micro-services gateway in Python's FastApi framework. My authorization service is written in Django and there are already generated by drf-yasg package swagger docs. I was thinking if there is a way to somehow import auth's schema to the gateway. I can serve the schema in json format via http and access it from the gateway. The question is how to integrate FastApi's docs with raw swagger schema file. 回答1: According to docs you can modify the openAPI json. Example: from