Reusing Response Definitions in OpenAPI with components.responses
Learn how to define a response once in OpenAPI's components.responses and reuse it with $ref to cut duplication and keep docs consistent.
Loading…
ReadMeFeed / Community knowledge
#api-design
Real questions. Useful conversations. Find the people who know your stack.
yaml
swagger
openapiChoosing Between Pydantic Models and Plain Dict Request Bodies in FastAPI
Guide comparing Pydantic models vs. plain dict request bodies in FastAPI, with a decision table, trade‑offs, and a working example.
fastapiEliminate Duplicate Response Definitions in OpenAPI with components.responses
Learn how to eliminate duplicate HTTP response definitions in OpenAPI/Swagger by moving them to components.responses and referencing them with $ref.
Modeling Polymorphic Responses in OpenAPI 3.1 with Discriminators
An API that returns different shapes for the same endpoint forces clients to guess. A discriminator in OpenAPI 3.1 makes polymorphic responses explicit by naming a property that selects the concrete subtype in a oneOf composition.
Debugging Schema Validation Errors in OpenAPI SDK Generation
Learn how to diagnose and fix schema validation errors when generating OpenAPI SDKs, focusing on circular references, type mismatches, and polymorphism ambiguity.
Decoupling API Responses with Laravel Eloquent Resources
Learn how to use Laravel Eloquent Resources to decouple your database schema from your API output, preventing sensitive data leaks and N+1 query performance issues.
laravelStop Polling: Using SpiceDB LookupResources for Dynamic Access Lists
Stop making hundreds of CheckPermission calls. Learn how to use SpiceDB's LookupResources to efficiently retrieve all resources a user can access in a single, paginated request.
spicedbImplementing Cursor-Based Pagination with the Facebook Graph API
Learn how to use cursor-based pagination in the Facebook Graph API to prevent data drift and duplicate records when retrieving dynamic datasets.
facebookPreventing API Drift with JSON Schema Validation
Stop relying on implicit API contracts. Learn how to use JSON Schema to enforce data integrity, handle polymorphism, and prevent breaking changes in distributed systems.
json