Skip to main content

5 docs tagged with "openapi"

View all tags

API Contract Governance, Linting & Testing

Run an API program at scale - design-first vs code-first, Spectral linting, oasdiff breaking-change gates, Prism mocks, OpenAPI Generator interfaces, Pact consumer-driven contracts, Schemathesis fuzzing, CI pipeline, API catalog and review process.

API Design — REST, gRPC & GraphQL

A complete guide to API design — REST principles, gRPC, GraphQL, pagination, rate limiting, idempotency, versioning, security, API gateway patterns, and production observability. Beginner through senior depth.

API Design, OpenAPI & Swagger Deep Dive

Senior-level API design handbook - OpenAPI/Swagger, contract-first workflow, naming conventions, resource modeling, errors, pagination, versioning, idempotency, security, governance and interview preparation.

OpenAPI & Swagger Fundamentals

Deep dive into the OpenAPI 3.x specification - document structure, components, JSON Schema 3.1, polymorphism with oneOf and discriminator, security schemes, callbacks and webhooks, Swagger UI/Editor/Codegen tooling, and common spec pitfalls.

Spring Boot + springdoc-openapi (Code-First Swagger)

Generate and govern OpenAPI specs from Spring Boot 3 with springdoc-openapi - annotations, groups, security schemes, polymorphism, Pageable, global error responses, customizers, exporting the spec in CI, and production pitfalls.