DEV Community

#openapi

Posts

đź‘‹ Sign in for the ability to sort posts by relevant, latest, or top.
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 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
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
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
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
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
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
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
PUT vs JSON Merge Patch vs JSON Patch: modeling partial updates in OpenAPI without the null ambiguity

PUT vs JSON Merge Patch vs JSON Patch: modeling partial updates in OpenAPI without the null ambiguity

Comments
5 min read
OpenAPI callbacks vs webhooks: modeling async request/reply with runtime expressions

OpenAPI callbacks vs webhooks: modeling async request/reply with runtime expressions

Comments
5 min read
Optional, nullable, or omitted? Modeling missing data in OpenAPI 3.1 without lying to clients

Optional, nullable, or omitted? Modeling missing data in OpenAPI 3.1 without lying to clients

Comments
5 min read
File uploads in OpenAPI: multipart/form-data, raw binary, and multiple files done right

File uploads in OpenAPI: multipart/form-data, raw binary, and multiple files done right

Comments
5 min read
Prevent lost updates with ETag and If-Match: optimistic concurrency in OpenAPI

Prevent lost updates with ETag and If-Match: optimistic concurrency in OpenAPI

Comments
4 min read
The JSON Schema constraints that actually work in OpenAPI: format, pattern, ranges, and what codegen and AI mocks do with them

The JSON Schema constraints that actually work in OpenAPI: format, pattern, ranges, and what codegen and AI mocks do with them

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