Using OpenAPI Components for Reusable Request and Response Schemas
Learn how to define shared schemas in the components section of an OpenAPI document, validate references, and avoid common pitfalls when reusing models across API endpoints.
Loading…
ReadMeFeed / Community knowledge
#api-design
Real questions. Useful conversations. Find the people who know your stack.
yaml
swagger
openapiObjective-C Nullability Annotations: Auditing Public Headers for Swift Interop
Wrap Objective-C public headers in NS_ASSUME_NONNULL regions and mark exceptions with nullable to get compile-time checks and correct Swift optional types.
objectivecStop Trusting Your Payloads: Using JSON Schema for API Boundary Validation
Stop relying on manual null checks and try-catch blocks. Learn how to use JSON Schema to validate API payloads at the boundary, ensuring only clean data reaches your business logic.
Decoupling FastAPI Logic with Dependency Injection
Stop writing 'fat' route handlers in FastAPI. Learn how to use Dependency Injection to decouple resource creation from business logic for cleaner, testable code.
python
fastapiHandling Polymorphic JSON in OpenAPI with the Discriminator Keyword
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.
typescriptBackbone.js validate() Is a UX Guard: Designing the Real Trust Boundary
Backbone's validate() improves UX but enforces nothing. Here's the smallest save/parse design that keeps the server authoritative, plus tests and failure modes.
backbonejs
javascriptDiagnosing HTTP PATCH Partial-Update Failures: JSON Patch vs JSON Merge Patch
HTTP PATCH endpoints fail or silently drop fields when JSON Patch and JSON Merge Patch are confused. Diagnose media-type, pointer, and concurrency causes, then apply targeted fixes.
jsonOffset vs Cursor Pagination in GraphQL: Which to Choose and How to Implement
Picking pagination for a GraphQL API is a trade-off between simplicity and stability. This guide compares offset and cursor pagination, shows trade-offs, and gives a concrete Relay Connection example you can validate.
graphqlFastify Schema‑Driven Validation and Serialization as an API Boundary
Learn how to place JSON Schema validation at the edge of a Fastify service and enforce response contracts with hooks, plus the checks and failure modes to monitor.
fastify