Requiring that all operational request body media types meets the policy standards.
Request Bodies Media Types
Rules
OpenAPI Request Body Have Application JSON Info
Request bodies should offer an application/json media type so that consumers have a predictable, widely supported content type for sending data to the API.
OpenAPI Request Body Have Application X WWW Form URL Encoded Info
Request bodies may offer an application/x-www-form-urlencoded media type to support form-style submissions alongside other supported content types.
Strategies
Operations Must Be Useful and Consistent
All individual API operations must be useful and follow consistent Internet, industry, and enterprise standards, providing a simple and relevant HTTP API operation that does one thing and does it w...
Lifecycle
design_services Design Design
Design is where the human experience of an API is won or lost. I work design-first, shaping the paths, schema, errors, and naming in the contract before development begins, so that consistency is b...
