Category "openapi"

OpenApi generator doesn't allow multiple schema in content

I've an OpenAPI contract like this: openapi: 3.0.1 info: title: Internal API version: '' tags: - name: Calendar description: Api for Calendar resource

How to include members of base entity in Swagger API Documentation?

I have something like these: BaseDTO public record BaseDTO { public virtual int Id { get; protected init; } public DateTime Timestamp {

FastAPI Textarea OpenAPI for Form Data

I am using Form Data format for APIs. The thing is how I am going to make OpenAPI input being larger by using textarea?

Automatic OpenAPI YAML generation

I am working on the backend of a Spring Boot application that uses OpenAPI and Swagger to provide the interface for frontend application via an schema.yml file.

validating multiple input query params in Mule 4

I am using Mule 4.4 community edition I have a GET endpoint with 4 query params: empId ( mandatory ) collegeId ( mandatory ) subject ( either subject or

Getting 405 error in OpenAPI swagger page if I put only path variable attributes in a Rest Controller

I am trying to create Swagger documentation using OpenAPI 3.0. I am using spring-boot-starter 1.5.4.RELEASE and springdoc-openapi-ui version 1.4.2 <parent>

How to add a banner/label to redoc

Looking at the Redoc demo and they have used a "Webhook" label beside their title but I couldn't figure out how to implement it specifically for other labels. H

Exact purpose of tags in OpenAPI and why are they unique

By Specification: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md A list of tags used by the specification with additional metadata

Spring Cloud Gateway and Springdoc OpenAPi integration

I was able to integrate Spring Cloud Gateway with the Springdoc OpenAPI in an small application with an architecture oriented to microservices. But now, when I

How to Integrate Open API 3 with Spring project (not Spring Boot) using springdoc-openapi

My Existing Project is on Spring Framework not Spring Boot. I want to integrate Open API 3 with it. I want to integrate using springdoc-openapi not using Jers

How to get pretty API names with RapidAPI from OpenAPI spec

I'm creating an API using RapidAPI and when I upload an OpenAPI spec, the web UI API names are populated using the OpenAPI spec operationId which is often camel

How to define in swagger spec either of two properties are not null and required

I have a requirement to have two properties in the payload say property1 and propert2. Both are array type. Condition is, that either both can have values, or o

What does 'required' in OpenAPI really mean

Given the following OpenAPI definition Person: required: - id type: object properties: id: type: string Which of the below objects are val

How to define a header parameter's default value is in OpenAPI 3.0

I have an endpoint that accepts a PUT without a body. The PUT causes an event to trigger on the backend, and our API design team decided that PUT was the best R

Can I generate an Open API 3 Python Flask server?

From http://editor.swagger.io/ with swagger 2.0 I am able to select: Generate Server-->python-flask and generate a python server that I can deploy and use.

How to document default None/null in OpenAPI/Swagger using FastAPI?

Using a ORM, I want to do a POST request letting some fields with a null value, which will be translated in the database for the default value specified there.

Swagger Codegen generates nested Lists by using array as response for spring server stub

I am using the cloud SwaggerHub Codegen Editor and wrote API like this: /foodlogs: get: tags: - foodlog summary: searches food logs operationId: searc

SpringDoc openAPI tool not scanning for APIs in Spring Boot Project

I'm having trouble getting this to work. I've started with a working SpringBoot (v2.2.2) app with a working @RestController. To get springdoc to work I've inclu

Can I suppress the default Optional<NativeWebRequest> getRequest() that OpenAPI generates into interfaces?

I have an OpenAPI 3.0 file that specifies two REST resources with operations, let's say: openapi: 3.0.0 [...] paths: /a: post: [...] /b post:

Springboot 2.6.7, springdoc 1.6.8 i need to have v3/api-docs and v1/api-docs

I'm trying to upgrade my springboot app from 2.5.9 to 2.6.7 so i needed to migrate from springfox 3.0.0 to springdoc 1.6.8 because of many compatibility issues.