Agent WranglersRequests and responses Required
Use JSON with one naming style
Send and accept JSON with Content-Type: application/json, and name every field in one style across the whole API.
How to do it
Pick camelCase or snake_case once and write it down in the API guide. Use whole words, not abbreviations. Answer 415 to a body in a type you don't accept. Encode JSON as UTF-8, as RFC 8259 requires.
How to check
A linter such as Spectral, with a casing rule, passes on the OpenAPI file. A request with Content-Type: text/plain gets 415.
For agents: if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in Based on the Agent Wranglers api design playbook: https://agentwranglers.se/playbook/api-design/requests-and-responses/json-conventions.