Designing APIs for AI Agents: Idempotency, Machine-Readable Errors, and 202 + Webhooks
Most APIs were designed for two consumers: a human reading documentation and code a human wrote once....
Tag archive
Most APIs were designed for two consumers: a human reading documentation and code a human wrote once....

Two pieces of the same web Browsers and apps need two different kinds of answers: REST...
Google's JSON Style Guide says to drop null properties. That breaks PATCH. Two AIP-based fixes: enum zero values (AIP-126) and update masks (AIP-134).
I built Quayat, a privacy-first chat app. Now it has a REST API for developers. The problem: Every...

GET /customers may work perfectly with 100 records. But what happens when the dataset grows to one...

REST vs. gRPC vs. GraphQL: Which API Style Should You Learn? Every backend and full-stack...

A valid token proves identity, not permission. Testing whether a user can access their own profile...

Say you are building a product page. The mobile team asks for one small thing: a heart icon that...

REST is flexible. GraphQL is precise. gRPC is fast. WebSockets are persistent. Webhooks are reactive....
How a QA handoff turned into a weekend rabbit hole and eventually an open-source library Tags: java,...
Every admin console ends up with a file upload — Excel imports, avatar pictures, PDF attachments....
Choosing an HTTP client is a "boring but expensive" decision: it touches every downstream integration...