Questions tagged [swagger-3.0]

121 questions
1
vote
0 answers

OpenAPI to define optional parameters with undefined names

Simple question: How do you write an OpenAPI spec. that accepts optional parameters with undefined names (i.e. the parameter names can be any random string)? Example: GET /api/someEndPoint GET…
user1589188
  • 5,316
  • 17
  • 67
  • 130
1
vote
0 answers

How to remove Request Body Examples Dropdown in swagger-php

I'm using Swagger 3.0 in tandem with swagger-php and getting strange behavior with request body markup . In the image, the "Examples:" dropdown shows up and "Example Value | Schema" shows up under that dropdown instead of "Example Value |…
1
vote
0 answers

How to define Open Api 3.0 documentation for requestBody of content " text / csv (UTF-8)"

I am new to swagger. I have an endpoint which is accepting input in the format of 'text / csv (UTF-8). I want to add open api documentation for the end point. But I am not finding any examples from the official website request body description…
1
vote
2 answers

Implementation of Swagger core v3 in java

I'm writing some API and I want to integrate Documentation while writing code, so I found Swagger as a good way to to this. I used Swagger core v3 notations, so my classes are something…
Heisenberg1
  • 49
  • 1
  • 6
1
vote
0 answers

How to use different labels for Basic Authentication credentials Swagger 3

My API is currently using Basic Authentication with api_xxx instead of username and api_xxy instead of password, do we have any specific schema for such a situation? Everything works exactly the same, I would like to change only the labels on the UI…
DanFlorin
  • 121
  • 1
  • 8
1
vote
1 answer

Serialize nested properties as form-data with swagger-php

This is how Encoding Object Example is done in OpenApi https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md requestBody: content: multipart/mixed: schema: type: object properties: id: …
Andrei Lupuleasa
  • 2,677
  • 3
  • 14
  • 32
1
vote
0 answers

Can there be parameter fields for content headers in the swagger-ui for specific form data contents under a multipart request body in swagger-3.0?

I am trying to create a swagger documentation for some REST API Calls. The POST method in one of the API Calls accept a multi-part form data content with 1st part as binary file data and 2nd part as json instance. I am looking for a way to allow the…
0
votes
0 answers

How to validate parameter with array data type in Swagger 3.0.0

I have a swagger .yaml file which generates java class as below: AlleleExportRequest: type: object properties: speciesId: type: integer format: int64 example: 17 required: true …
Abdusoli
  • 661
  • 1
  • 8
  • 24
0
votes
0 answers

How to rename the generated client SDK project by modifying the input json

I am using the https://editor.swagger.io/ to generate SDK. When I generate the SDK by selecting Generate Client -> CSharp, the SDK project is generated. But the problem is, I could not modify the project-name and namespaces. It by default gives the…
0
votes
1 answer

OpenAPI Swagger for springboot application

I've started to develop a small springboot application and I wanted to document it's API (every existing endpoint) using Swagger. However, doesn't matter which version of Swagger I'm trying to implement, I always end up with 404 response code while…
0
votes
1 answer

Swagger V3 UI Not Sending In Authorization Header When 'Trying it Out"

I have a Spring Boot App (2.7.10) and am using the Sprspringdoc-openapi-ui dependency (1.6.15). I have annotated my controller and it seems to be displaying correctly, however when I try and execute one of the endpoints which requires an…
ustad
  • 459
  • 1
  • 6
  • 21
0
votes
0 answers

Issues with openapi 3 documentation (swagger) in spring boot 3

When using the openapi 3 documentation (swagger) in a spring boot 3 application, swagger documents controllers and methods unknown to me, what could be the problem? @OpenAPIDefinition( info = @Info( title = "Billing System…
Kirill
  • 1
  • 1
0
votes
0 answers

Failed to get the response in Swagger 3 (open api) while using Java 19 and Spring Boot 3.0.x

I'm migrating from Spring Boot 2 to Spring Boot 3 with Java 19 and also using swagger 3 that's open api. I have added the "open api webmvc ui" dependency in POM file and also changed Javax to Jakarta. I have configured in open api configure file.…
0
votes
0 answers

Add a pattern in a header parameter - Swagger OpenAPI

It is possible to add a pattern to a header parameter? I am putting patterns to some fields in an JAVA application using swagger OpenAPI in the YAML file. In the body fields, i was able to put some patterns with no problem at all. I also tried to…
Borsoi
  • 1
  • 3
0
votes
1 answer

Swagger 3 Open API doesn't display api details with same endpoint but with different parameter

I am working on Springboot 2.6.8 version and integrating Swagger 3 using springdoc-open-ui dependency. Integration works fine and Swagger-ui.html displays the API documentation. But I have multiple API's with same endpoint with different parameters.…
user1111880
  • 443
  • 5
  • 8
  • 26