» Tag
api-design
17 postsHTTP QUERY Method Arrives: Is Your Infrastructure Ready?
IETF's new QUERY HTTP method fixes the POST-for-search compromise, but CDN, WAF, and framework support still lag behind. A practical engineering guide to what's ready and what isn't.
mcpgrade audit: a third of 36 popular MCP servers score D or F
mcpgrade graded 36 MCP servers on agent usability, not spec compliance — a third scored D/F due to undocumented parameters and naming collisions.
Idempotency Fundamentals: Engineering API Guarantees at Scale
A practical breakdown of idempotency in distributed systems: request flow, failure boundaries, key state machines, and storage trade-offs.
CommitBrief — AI code reviews, right in your terminal
A provider-agnostic, local-first CLI that reviews your staged changes, a historic range, or a whole GitHub pull request. Zero telemetry, no server. Free and open source.
commitbrief.comDuckDB Parquet Paging: file_row_number vs OFFSET, and a Correctness Trap
DuckDB Parquet paging compared: file_row_number vs OFFSET performance, plus a hidden data-correctness risk in parallel scans.
Building APIs for AI Agents: A Practical Playbook
How crmkit's agent-first API design reshapes conventions: text over JSON, short IDs, bulk operations, and self-documenting endpoints.
Solo Lead Playbook: Running Product, Architecture and Backend with AI Agents
How one founder runs product, architecture, and backend engineering solo using a single AI coding agent, one collaborator, and a five-phase workflow.
When Agent Tools Return Empty: Who Decides What It Means
Why empty results from agent tool calls hide three distinct failure states, and how typed states, evidence, and retry semantics fix the gap.
Draft Spec Proposes Unified Server-Side HTTP API for JS Runtimes
A draft spec proposes a unified server-side HTTP API using ServerContext to reconcile Node, Deno, Bun, and edge runtime differences.
Per-Row Reservation Pattern for Billing Bulk API Batches
A bulk GSTIN verification endpoint reveals why single balance-check billing fails when some rows are free, and how per-row atomic reservation fixes overselling and race conditions.
HTTP Gets a New Method: How QUERY Reshapes API Design
RFC 10008 defines HTTP's new QUERY method, letting APIs send safe, idempotent, cacheable complex queries without abusing POST semantics.