Adding a field is safe by convention and unsafe in practice, because a client generated from a schema with additionalProperties: false rejects it. Stating what may change is…
A secret that can only be replaced atomically cannot be rotated without coordinating a deploy on somebody else’s system. The multi-value header is the arrangement every large provider…
serialize on a pure enum stores the case name, and on a backed enum stores the value, which makes the two behave differently across a rename. Native serialisation…
Every API invents an error envelope and RFC 7807 is a perfectly good one that some client libraries already understand. type is the field a client branches on…
A number chosen by engineering alone is a number the business has not agreed to constrain the roadmap with, which is what an objective is for. Presenting it…