swagger

问题 I have 2 HTTP GET method in same controller and give me this error HTTP method "GET" & path "api/DataStore" overloaded by actions - DPK.HostApi.Controllers.DataStoreController.GetByIdAsync (DPK.HostApi),DPK.HostApi.Controllers.DataStoreController.GetAllAsync (DPK.HostApi). Actions require unique method/path combination for Swagger 2.0. My Controller : [Route("api/[controller]")] [ApiController] public class DataStoreController : ApiControllerBase { private readonly IDataStoreService

问题 I have 2 HTTP GET method in same controller and give me this error HTTP method "GET" & path "api/DataStore" overloaded by actions - DPK.HostApi.Controllers.DataStoreController.GetByIdAsync (DPK.HostApi),DPK.HostApi.Controllers.DataStoreController.GetAllAsync (DPK.HostApi). Actions require unique method/path combination for Swagger 2.0. My Controller : [Route("api/[controller]")] [ApiController] public class DataStoreController : ApiControllerBase { private readonly IDataStoreService

问题 I am getting a blank page with just a "Django Login" link when trying to access generated swagger docs. I am using drf_yasg library to render swagger documentation. Code to generate swagger docs is similar to mentioned in swagger docs. schema_view = get_schema_view( openapi.Info( title="Snippets API", default_version='v1', description="Test description", terms_of_service="https://www.google.com/policies/terms/", contact=openapi.Contact(email="contact@snippets.local"), license=openapi.License

问题 I'd like to know how to specify a JSON schema for an array of different objects. This thread gives me half the answer, but fails when I have multiple instances of each type of object. Here's a sample XML, based on the example given here but with the " Product " object being repeated:- { "things": [ { "entityType" : "Product", "name" : "Pepsi Cola", "brand" : "pepsi" }, { "entityType" : "Product", "name" : "Coca Cola", "brand" : "coke" }, { "entityType" : "Brand", "name" : "Pepsi Cola" } ] }

问题 We have a .Net Core 2.2 Web Api that uses swagger ui to expose the Web Api definitions. We want to secure this endpoint to only users inside of a certain AD Group. We currently are using Both Windows and Anonymous Authentication. Problem is we cannot enforce Swagger to use Windows Authentication to block users. Any Ideas? 回答1: Although frustrating, the easiest path to securing the Swagger endpoint (via Swashbuckle) I've found thus far is just to put it under its own route and then use a

问题 The following YAML: openapi: 3.0.0 info: title: test version: 1.0.0 paths: /test: get: summary: test responses: '200': description: Test content: application/json: schema: oneOf: - allOf: - type: object properties: firstA: type: string - type: object properties: firstB: type: string - allOf: - type: object properties: secondA: type: string - type: object properties: secondB: type: string Does not render at all in the swagger editor. In ReDoc it also fails to render properly: If nesting

问题 How do I indicate that in my_object you can have property_1 or property_2, but not both? my_object: type: object properties: property_1: type: string property_2: type: string 回答1: You may want to switch to OpenAPI 3.0, which supports oneOf keyword to define mutually exclusive conditions: here is an example : my_object: type: object properties: property_1: type: string property_2: type: integer oneOf: - required: [property_1] - required: [property_2] 回答2: In OpenAPI 3.0 ( openapi: 3.0.0 ), you

问题 How do I indicate that in my_object you can have property_1 or property_2, but not both? my_object: type: object properties: property_1: type: string property_2: type: string 回答1: You may want to switch to OpenAPI 3.0, which supports oneOf keyword to define mutually exclusive conditions: here is an example : my_object: type: object properties: property_1: type: string property_2: type: integer oneOf: - required: [property_1] - required: [property_2] 回答2: In OpenAPI 3.0 ( openapi: 3.0.0 ), you

问题 I followed the following link from swagger documentation to create swagger json for my rest api. https://swagger.io/docs/specification/2-0/describing-request-body/ In my rest api, I have request body and http headers like Content-Type and Authorization that go along with the service request. I was wondering if there is a way to include request body and http header information in the swagger json ? I don't see that information in the swagger docs. 回答1: The Content-Type header of requests and

问题 I've hosted a nodejs server on localhost generated using Swagger and I'm trying to make API calls to it using Swagger UI again hosted on localhost. The network profile in chrome is showing connection refused everytime I'm making a call because CORS header are not added to the request. This is my app.js file which was generated using Swagger: 'use strict'; var SwaggerExpress = require('swagger-express-mw'); var app = require('express')(); module.exports = app; // for testing var config = {