DEV Community

#openapi

Posts

đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.
Are you migrating from Spectral? Redocly just got something to help you with that!

Are you migrating from Spectral? Redocly just got something to help you with that!

15
Comments
6 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
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
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
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
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
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
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
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
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
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
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
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
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
đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.