Posts tagged "api design"

API schema changes are not only field changes. Separate source contracts from product meaning, preserve evidence, and evolve mappings without spreading breakage.

When you sync two systems with webhooks, the copy slowly becomes wrong: some events are lost, some are duplicated, some arrive in the wrong order. Reconciliation is the way to make the two systems agree again. Here is how to design an API for it.

Most API errors are written for a human reading logs, not for the program that has to react. Here is what most APIs do, what the standard says, and the small set of rules that actually make errors useful.

Offset pagination is easy to write and breaks in two ways: it gets slow, and it skips or repeats rows when the data changes. Cursor pagination fixes both. Here is the difference.

A request times out, you retry, and now the customer is charged two times. An idempotency key is the small idea that makes retries safe. Here is what it is and how to build one.