12,424 questions
0
votes
1
answer
28
views
"No operations defined in spec!" when using MMLib.SwaggerForOcelot to build combined swagger for Ocelot
This is my ocelot configuration...
{
"Routes": [
{
"UpstreamPathTemplate": "/api/test/{url}",
"DownstreamPathTemplate": "/api/{url}",...
- 251
Best practices
1
vote
2
replies
103
views
Best Practice: use of allOf in OpenAPI specification
I'm currently in a Project designing/extending an API for a customer. At some points, the existing Definiton uses the allOf Keyword in the schemas to combine different Subschemas, e.g.:
"Foo"...
- 43
1
vote
0
answers
46
views
RestController post endpoint multipart_form_data with @ParameterObject and MultipartFile can't be executed from Swagger-UI
I have a class with the @RestController annotation which contains an endpoint defined like this
@PostMapping(path = "/submitJob", consumes = { MediaType.MULTIPART_FORM_DATA_VALUE }, ...
0
votes
0
answers
64
views
Issues with polymorphis in Swagger (springdoc) in Spring Boot after upgrading to 3.5
I have created a very simple demo project with one controller endpoint:
Spring Boot 3.5.6
Springdoc 2.8.13
This was working much better in Spring Boot 2.7.x
Full project here: https://github.com/...
- 139
0
votes
0
answers
51
views
Kotlin/Spring Boot and Swagger Docs show inherence of data class models when using openapi-generator-maven-plugin (Polymorphic DTOs)
I’ve built a Spring Boot REST API that exposes an endpoint returning a list of animals (/animals).
The API supports multiple animal subtypes (Cat, Bird), each with unique fields, and I’ve modeled them ...
- 1,422
-1
votes
1
answer
43
views
How to correctly define additionalProperties with example in l5-swagger / Swagger-PHP?
I am trying to document a Laravel API using l5-swagger (swagger-php). I have a request body where one property is a map of wallet IDs to effective dates, like this in PHP:
[
11 => "2025-12-...
1
vote
0
answers
70
views
Documenting a Map<String,List<Thing>> properly with Swagger's Java annotations
I'm having trouble finding a solution to documenting a Map<String, List<Thing>> properly using Swagger annotations and Open API. Thing is annotated properly, but I cannot find the correct ...
- 1,419
0
votes
0
answers
72
views
Visual Studio debugger crashes when selecting IFormFile in Swagger UI
I'm running an ASP.NET API in Visual Studio. I have an endpoint to upload a file using IFormFile.
[HttpPost(Name = "AddDocument")]
[ProducesResponseType(StatusCodes.Status200OK)]
public ...
0
votes
0
answers
41
views
Groovy/Grails Ambiguous mapping error with springdoc swagger
This is my controller
package example.infra.adapters.input.api.v1.endpoints
import example.aplication.services.authentication.LoginAuthenticator
import example.aplication.dtos.authentication....
- 9
1
vote
1
answer
105
views
Is there any way to get Swagger document of a project without running it?
I want to download Swagger file of project X in my Analyzer project but I don't want to run project X.
I have access to project X's source code & I can build the solution.
I tried dotnet swagger ...
- 11
0
votes
0
answers
34
views
OAS Generator creates classes even for referenced schemas
I have two yml files
Common.yml and application.yml
Both under same folder
I have certain schemas like sortOrder that are defined in common schema
And using $ref it is referred in application.yaml
...
0
votes
0
answers
43
views
Flutter:DOI - Why it keep sending 200 Response to Catch Block
So i am using Swagger Documentation and OpenAPI CLI Tool to auto generate Api Call etc Logics
final response = await _api
.getAuthenticationApi()
.authControllerRegisterV1(
...
- 21
1
vote
0
answers
71
views
How to add format, pattern and maxlength?
How do I add information to Swagger docs for:
format
pattern
max length
I was thinking just put them on a object and add attributes, but I need them to be a primitive because I am using them in the ...
- 7,047
1
vote
1
answer
204
views
How to receive an array of objects (with IFormFile) using [FromForm] in ASP.NET Core Web API?
I'm building an ASP.NET Core Web API endpoint that needs to receive an array of complex objects via multipart/form-data. Each object includes key-value string pairs and an optional file upload. Each ...
- 644
0
votes
0
answers
63
views
Micronaut OpenAPI does not generate merged file using micronaut.openapi.additional.files from dependent module YAMLs
I'm trying to generate a single OpenAPI YAML file in an aggregator module that imports other Micronaut modules as dependencies.
Context
I have multiple modules (A, B, C) that define Micronaut ...
- 1
0
votes
0
answers
19k
views
DevOps Release: Failed to import from specified resource http://10.XXX.XXX.XXX/swagger/XXX/swagger.json
In a DevOps Release I am getting suddenly this error in "API Management - Create or Update API" step:
2025-06-25T10:48:25.3264215Z Creating or updating API https://management.azure.com/...
- 123
-3
votes
1
answer
98
views
Can I fill schema gaps with a document via MS Kiota's CLI?
Kiota is a command-line tool that consumes an OpenAPI/Swagger specifications of a more-or-less REST-ful API and generates code for client(s) to call the API.
I am faced with an OpenAPI/Swagger JSON ...
- 101k
1
vote
0
answers
67
views
Swagger UI is unable to render this definition, but only on the server
I am creating two separate swagger pages for my API.
One "Full" page with all endpoints for internal use and one "Limited" page for external users.
So I have added this decorator ...
- 97
1
vote
1
answer
59
views
Is it compatible MatrixParams in SWAGGER UI with JAXRS annotations?
Im working on a project based on JAXRS annotations. Im configuring a Swagger UI to sumarize all the endpoints of the project and to execute them from there. Im implementing OAS 3 which supports ...
0
votes
0
answers
26
views
The Type Point in geojson_pydantic is not hashable
I'm using Python 3.11 and I am struggling a lot to understand this.
When I try to access to the Swagger documentation of my service, in localhost, I have this error:
generate_definitions ...
- 1,546
1
vote
1
answer
72
views
How can I auto-generate nested OpenAPI (Swagger) request bodies from Laravel FormRequest rules()?
I’m using L5 Swagger in a Laravel project to generate OpenAPI documentation. I’ve written a custom command (app/Console/Commands/GenerateSwaggerAnnotations.php) that parses controller methods and ...
- 11
1
vote
0
answers
43
views
spring boot maven web api - open swagger if not already opened
I have a Spring boot java 23 web api using maven.
In my pom.xml I am using springdoc-openapi v2.8.8:
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-...
- 631
1
vote
0
answers
175
views
Swagger url-encodes catch-all path parameter. How to disable? [duplicate]
I have an asp.net-core project that acts as a proxy to different other services.
So, a user would send a GET-request to <myproxy>/someservice/foo/bar/baz, where my proxy would send a request to ...
- 1,879
-1
votes
1
answer
51
views
Show description of each API endpoint method for Swagger doc with flask_restx
I have something like this for my Flask app using flask_restx:
from flask import Blueprint, request
from flask_restx import Api, Resource, Namespace
blueprint = Blueprint('location_api', __name__)
...
- 1,342
0
votes
1
answer
121
views
Reflect "CatchAll" asterisk on swagger.json schema
I have controller with some methods. One of them has parameter with "CatchAll" asterisk, this is to allow sending values that contain /.
[HttpGet]
[Route("Check/{*routeAddress}")]...
- 1,156