The Old Fashioned Approach to API Design
Keep It Simple
The best APIs, like the best Old Fashioneds, don't try to do too much. Spirit, sugar, bitters, ice. Endpoint, method, payload, response.
When you overcomplicate either one, you lose what made it elegant in the first place.
The Ingredients
{
"method": "POST",
"endpoint": "/payments",
"body": {
"amount": 4200,
"currency": "usd",
"description": "Barrel-aged consulting"
}
}
Stir, Don't Shake
Iterate on your API design before you ship it. Talk to the consumers. Prototype. Adjust. A little patience up front saves a lot of breaking changes later.
Just like stirring a cocktail — it takes longer than shaking, but the result is crystal clear.