Category "openapi"

Can I enforce query parameter order in OpenApi?

The reason is for CDN cache entries. Those are specific strings used as cache keys and to invalidate them they need to match. Preferably, I'd like to enforce th

Custom openapi schema with rust, rocket and okapi

I am developing an API with Rust, using Rocket as main framework. To create the Swagger docs I use Okapi, which allows me to create the docs automatically. use

Golang struct to Json schema

Hi I need to infer a json schema (github.com/go-openapi/spec.Schema) from a struct : type Testcase struct { Id string `json:"id,omitempty"`

Is there a tool to manage in house extensions to third party OpenAPI specifications?

I'm using a SaaS platform and have used their OpenAPI spec to generate a Python client to interact with the services programmatically. They have some gaps in th

Separate FastApi documentation into sections

Currently the OpenAPI documentation looks like this: Is it possible to separate it into multiple sections? For example, 2 sections, one being the "books" secti

Google API Gateway: Authorization Header not forwarded

I have a google cloud api gateway deployed to send requests to a cloud run service. The cloud run service hosts a laravel docker container image and to authenti

Override default auth in SAM templates and Open API

I have made a SAM template that deploys a mix of public and authenticated endpoints. The default auth is oauth. For public endpoints, I use overrides to make it

How to do multiple (simultaneous) versions of APIs with OpenAPI and express-openapi?

Re: https://www.npmjs.com/package/express-openapi#getting-started On many projects I've been worked on (in other technologies) we would always support multiple

Hide property in a subclass of a @ParameterObject with springdoc

We are migrating from spring-fox to springdoc. Sometimes we need to hide properties from common base classes that are used in @ParameterObjects. With spring-fox

Custom Connector ( JSON result convert into Paramters )

List item I am a newbie in the azure environment. I am getting JSON response from my custom connector but I need to convert that JSON into parameters so I can u

Swagger OpenAPI describing string array in multipart request

I need to describe a multipart query that has an array of strings. But I ran into a problem, in the query, the array elements are combined into one string inste

Configure Open API 3 - SpringBoot with multiple controller classes

Am trying to configure swagger 3 spring documentation for my springboot application. I have 3 controller classes with 1 functional endpoint method each. If I op

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