API Contracts
posts (4)
- The Layers of HTTP in the Browser: From fetch() to QUIC2/9
Methods and Status Codes: Semantics, Not Decoration
The method and the status tell the browser and the infrastructure what may be done with a request. That is why retrying a POST is a different decision than…
- Testing Through Layers: From Code to Infrastructure4/9
Contract Tests and API Tests: The Public System Agreement
A contract test protects the agreement between systems, while an API test checks the behavior of a public interface. Both matter where a change stops being…
- Ways of Talking to a Backend: From HTML Forms to GraphQL5/6
RPC: When an API Models Operations Instead of Resources
RPC starts from the operation, not the resource. Intent becomes explicit, but the semantics move out of HTTP and into the application contract.
- Ways of Talking to a Backend: From HTML Forms to GraphQL4/6
REST: Resources, Representations, and HTTP Semantics
REST is not "JSON plus endpoints". It is resources identified by URIs, representations kept separate from the resource, and the meaning of HTTP methods put to…