4,738
questions
-1
votes
0
answers
16
views
How do I implement an inline oneof in properties
"properties":{
"ownername":{
"type":"string"
},
"oneOf": {
$ref: “#/components/schemas/Animal
}
}
I’m ...
0
votes
1
answer
19
views
Springdoc with Boot 3, no explicit OpenAPI bean declaration
I have trouble creating Swagger/Open API endpoints for my app. There was a previous app where such an endpoint was created automatically. I want to avoid explicitly declaring an OpenAPI bean. My ...
- 87
0
votes
1
answer
59
views
AddOpenApi - Adding Error Response types to all operations - .NET 9
I am upgrading a project from .NET 8 to .NET 9. The default support for Swagger UI and Swagger Docs has been removed and replaced with the AddOpenApi() and MapOpenApi().
In my Swagger json file, I ...
- 7,208
0
votes
0
answers
14
views
How to Implement OpenAPI v3 in Spring 6 (without Spring Boot)?
I am working on a project that uses Spring 6 but does not use Spring Boot. I want to implement OpenAPI v3 to document and interact with my REST API, but I only see examples and documentation on Spring'...
- 1,736
1
vote
0
answers
31
views
Change enums and OpenAPI spec at runtime
I have a FastAPI application serving data to other systems. This data is categorized (for the sake of the example) by different car manufacturers (e.g., VW, Skoda, ...). In our app, we have a class ...
- 11
0
votes
1
answer
31
views
Request and response model not loading on swagger UI when migrating from swagger 1.2 to swagger 2.0
Q&A (please complete the following information)
OS: macos
Browser: chrome
Version: 130.0.6723.117
Method of installation: https://swagger.io/docs/open-source-tools/swagger-ui/usage/installation/#...
- 380
0
votes
0
answers
22
views
Swagger why is #/components/schemas/ missing for some of my $ref?
I'm generating an OpenAPI spec using org.springdoc:openapi-gradle-plugin:1.9.0 and org.springdoc:springdoc-openapi-ui:1.8.0 in a project using Boot 2.
All of the referenced schemas are defined at the ...
- 11.9k
0
votes
0
answers
18
views
How to generate multiple ApiClients with different base paths so each client can consume different services with openapi-generator in Gradle
I'm trying to generate two different clients with openapi-generator using the Gradle plugin in a springboot project, each client has its own spec.yaml and each spec.yaml has its own path for server....
2
votes
1
answer
24
views
How to use openapi "parameters" section described in separate files?
I use openapi v3.0.3
I have 3 parameters
- name: query
in: query
description: ''
required: false
schema:
type: string
- name: limit
in: query
description: ''
required: false
schema:...
- 602
-2
votes
0
answers
38
views
JSON Schema for OpenAPI? [closed]
I'm writing an OpenAPI-enabled service. I want my CI to be able to verify the correctness of every endpoint my server offers.
This should include my service's OpenAPI 3.1 specification itself, which ...
- 2,515
0
votes
1
answer
22
views
Vert.x OpenAPI v4.5.10 ValidatorException: "The related request does not contain the required body" for POST request
I'm working with Vert.x and OpenAPI to create an HTTP server, and I'm encountering a ValidatorException when handling a request with a required body. Specifically, the error message is: The related ...
0
votes
1
answer
22
views
How to hide/exclude certain properties of schema for response in yaml file?
For example I have schema, described below. In the first case I want to return all fields, in the second case I want to return all except "healty" and "color". For some reason I do ...
- 602
0
votes
0
answers
40
views
What is correct way to declare timestamp "2024-09-24T07:26:51.198+00:00" in OpenAPI 3.0? [duplicate]
What is correct way to declare timestamp "2024-09-24T07:26:51.198+00:00" in an OpenAPI 3.0 spec?
I think the following should work, but it is not working.
type: object
properties:
...
- 485
-2
votes
0
answers
29
views
Tool to document APIs, export Swagger [closed]
I have received a task to find a tool that could serve as a technical documentation portal for documenting SDKs and APIs for internal and external users. This portal should include code examples for ...
1
vote
4
answers
68
views
Use OpenAPI 3.1 Schema to validate an OpenAPI spec
I've been using the OpenAPI 3.0 schema to validate OpenAPI 3.0 specifications. However, I don't seem to be able to use the OpenAPI 3.1 schema to validate an OpenAPI 3.1 specification.
With OpenAPI 3.0 ...
- 2,102