Posts Tagged: POST

Understanding Idempotency and Safety in API Design

What does it mean in programming to be idempotent? Today, we’re going to look at the concepts of idempotence and safety, and identify what makes them so very important in the context of web API design.

We’ll compare idempotence and safety to see how they’re different, and discover why this division is important. Read more

A Pragmatic Take On REST Anti Patterns

Do you ever have those moments when you’re asked to do something that feels technically wrong? Putting milk in the cup before the tea? (a very British problem admittedly). An overflowing trash can YOU must always empty? We all have our pet peeves — it’s what makes us human. Read more

REST State Machine Revisited

In the months after the publication of Designing a True REST State Machine and the talk it was based on, there has been quite a bit of discussion and the questions posed should be addressed. While each could be responded to individually, perhaps they might be better served by writing everything up in a blog post. Read more

4 Design Tweaks to Improve API Operations

We’ve previously discussed best practices when it comes to designing an API with quality developer experience. But what will the long term operational repercussions be for the design moves we make now?

For example, if URLs are designed without metadata to describe actions, later on, product owners will have a difficult time staring at unintelligible logs. Read more

Stop Polling and Consider Using REST Hooks

Web APIs have been around for a long time now. While that means there’s a lot of great tools from a lot of amazing developers, it also means that, as a community, the API space has held on to some practices for a long time — some would argue too long in many cases. Read more