ReadMeFeed / Community knowledge
Real questions. Useful conversations. Find the people who know your stack.
Developer tools · #swagger
OpenAPI's discriminator keyword lets you model polymorphic payloads—like multiple payment methods—in a single schema. This post shows how to define the mapping, see it work in Swagger UI, and generate type-safe clients without custom validation code.
OpenAPI 3.0 components eliminate duplication in large specs, but over-abstraction hurts readability. Learn when to extract schemas, parameters, and responses—and how to validate them.
Learn how Swagger UI and OpenAPI 3.0 annotations turn your code into a living API contract, eliminate documentation drift, and enable safe in‑browser testing.
Implementing OAuth2 Authorization Code flow in Swagger is straightforward: declare the flow in the spec, configure Swagger UI, and add a stateless JWT validator. Follow the checklist to avoid common pitfalls and know when to redesign.
Deciding between Code-First and Design-First OpenAPI strategies in Spring Boot. Compare trade-offs between development velocity and contract stability with implementation examples.
Ballerina’s automatic OpenAPI generation turns your HTTP service into a ready‑to‑use Swagger spec. Learn how to leverage annotations, serve the spec, and validate it in a few simple steps.
A practical guide to linting, diffing, and CI-enforcing your OpenAPI spec so breaking changes fail before merge.
Learn how to eliminate redundancy in OpenAPI 3.0 specifications by using components/schemas and $ref pointers to create a single source of truth for your data models.
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.
openapi
typescript
yaml
ballerina