Designing a search endpoint in OpenAPI: q, filters, sorting, sparse fieldsets, and pagination codegen understands
A search endpoint decays into a pile of ad-hoc query params every client guesses at: filter[status], status_in, q, and a sort string nobody documents. Standardize full text with q, give filters explicit operators and types, use a sign convention for sort, and add sparse fieldsets for payload...