DEV Community

#openapi

Posts

đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.
OpenAPI enums vs const: closed lists, open-ended strings, and how to add a value without breaking clients

OpenAPI enums vs const: closed lists, open-ended strings, and how to add a value without breaking clients

Comments
5 min read
Designing a search endpoint in OpenAPI: q, filters, sorting, sparse fieldsets, and pagination codegen understands

Designing a search endpoint in OpenAPI: q, filters, sorting, sparse fieldsets, and pagination codegen understands

Comments
5 min read
OpenAPI docs renderers compared: Swagger UI, Redoc, Scalar, Stoplight Elements, and RapiDoc on one spec

OpenAPI docs renderers compared: Swagger UI, Redoc, Scalar, Stoplight Elements, and RapiDoc on one spec

Comments
6 min read
Enforce an API style guide in CI with Spectral: custom rules that stop bad OpenAPI before it merges

Enforce an API style guide in CI with Spectral: custom rules that stop bad OpenAPI before it merges

Comments
5 min read
Bulk and batch API endpoints: modeling create-many, partial success, and 207 Multi-Status in OpenAPI

Bulk and batch API endpoints: modeling create-many, partial success, and 207 Multi-Status in OpenAPI

Comments
5 min read
Modeling money and big integers in OpenAPI: int64 precision, decimal amounts, and why number fails for currency

Modeling money and big integers in OpenAPI: int64 precision, decimal amounts, and why number fails for currency

Comments
5 min read
Multiple security schemes in OpenAPI: AND vs OR, optional auth, and per-operation overrides

Multiple security schemes in OpenAPI: AND vs OR, optional auth, and per-operation overrides

Comments
5 min read
Recursive and cyclic schemas in OpenAPI: self-referencing $ref for trees, nested comments, and graphs

Recursive and cyclic schemas in OpenAPI: self-referencing $ref for trees, nested comments, and graphs

Comments
5 min read
operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable

operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable

Comments
5 min read
readOnly and writeOnly in OpenAPI: one schema for create, response, and password fields

readOnly and writeOnly in OpenAPI: one schema for create, response, and password fields

Comments
5 min read
Dates, times, and time zones in OpenAPI: date-time, date, duration, and the timezone mistakes that shift bookings

Dates, times, and time zones in OpenAPI: date-time, date, duration, and the timezone mistakes that shift bookings

Comments
5 min read
OpenAPI servers and server variables: local, staging, production, regions, and per-tenant hosts from one spec

OpenAPI servers and server variables: local, staging, production, regions, and per-tenant hosts from one spec

Comments
5 min read
Validate HTTP requests and responses against OpenAPI at runtime: middleware, proxies, and fail-open vs fail-closed

Validate HTTP requests and responses against OpenAPI at runtime: middleware, proxies, and fail-open vs fail-closed

Comments
6 min read
OpenAPI additionalProperties: modeling maps, dictionaries, labels, and free-form objects without losing types

OpenAPI additionalProperties: modeling maps, dictionaries, labels, and free-form objects without losing types

Comments
5 min read
File downloads in OpenAPI: CSV, PDF, ZIP, images, Content-Disposition, and non-JSON responses

File downloads in OpenAPI: CSV, PDF, ZIP, images, Content-Disposition, and non-JSON responses

Comments
5 min read
đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.