API Design

2 articles tagged API Design.

Developer Tools11 Dec 20253 min read

API design for B2B partners: versioning, errors and documentation that speed up integration

Partners judge a platform by how quickly they can integrate. Practical guidance on resource design, versioning, error formats, pagination, authentication, sandboxes and documentation for B2B APIs.

Software Engineering3 Oct 20253 min read

Idempotency in booking and payment APIs: how to never charge or book twice

Timeouts and retries are normal in distributed systems. Idempotency keys, state machines and reconciliation make booking and payment flows safe to retry, without duplicate charges or orphaned reservations.