Switch API base URLs across environments with OpenAPI 3.0 server variables
Use OpenAPI 3.0 server variables to select base URLs for development, staging, and production without duplicating API paths.
Loading…
ReadMeFeed / Community knowledge
#openapi-3
Real questions. Useful conversations. Find the people who know your stack.
swaggerDiagnosing OpenAPI 3.0 $ref Resolution Failures
Fix unresolved OpenAPI 3.0 $ref references by checking target files, base URIs, document version, and schema cycles.
openapiReusing a Paginated Response Model with OpenAPI components.schemas
Show how to define a reusable pagination envelope in OpenAPI 3.0 using components.schemas and $ref, with a working YAML example, validation commands, and limits to watch for.
yamlImplementing OAuth2 Security with Swagger Annotations in Spring Boot
Define a global OAuth2 security scheme once, map it with @SecurityRequirement, and verify the spec and UI. This guide shows the exact annotations, a working config, and common pitfalls to avoid.
Choosing an Authentication Scheme for OpenAPI 3.0 Specifications
Learn how to choose between API Keys, OAuth2, and Bearer tokens for your OpenAPI 3.0 specs, with a practical guide to implementing JWT authentication in Swagger UI.
Annotation-driven vs contract-first OpenAPI spec for CI-validated TypeScript clients in Spring Boot 3.x
A Spring Boot 3.x service using springdoc-openapi v2.x needs a single source of truth for the OpenAPI 3.1 specification that supports CI validation of breaking changes and reliable generation of typed TypeScript clients. The decision is between annotation-driven code-first generation from Spring MVC annotations with springdoc runtime output at /v3/api-docs,
Does Swagger UI retain the selected server across page reloads in embedded deployments?
When an OpenAPI 3.x document defines multiple servers entries, Swagger UI renders them as a dropdown for "Try it out" requests. The first entry in the array is selected by default, yet the behavior after a user changes that selection and reloads the page varies across releases and embedding contexts. Recent standalone Swagger UI distributions appear to persi