APIs
Public and internal APIs: design, auth, webhooks, quotas, and what callers — including other software — need back.
- May- 2025 -25 May
How to Document an API People Will Not Read Twice
The API reference page that gets the most traffic in a typical developer portal is the one for the endpoint everyone already knows how to call.
Read More » - May- 2025 -22 May
Requirements for Webhooks That Survive Retries
Stripe publishes a document describing how it signs webhook payloads and how many times it will redeliver a failed one. The retry schedule runs for three days, with increasing gaps between attempts.
Read More » - May- 2025 -13 May
How to Test an API Before Customers Hit It
A staging environment that returns 200 OK on every endpoint has proven almost nothing.
Read More »