File downloads in OpenAPI: CSV, PDF, ZIP, images, Content-Disposition, and non-JSON responses
APIs return more than JSON: CSV exports, PDF invoices, ZIP archives, resized images, and generated audio. Model them with the right media type and string/binary schema, document Content-Disposition and Range, and distinguish inline from attachment. Here is how to describe downloa
Oct 8, 20266 min read