[EN] How to Organize a REST API Tree to Survive Time (and Org Chart Changes)

Also available in Spanish

Before designing an endpoint, classify its nature. Only then choose its location.

The Silent Problem

There are many articles explaining how to write a REST API. Here, instead, we will focus on a prior question: how to decide where an endpoint should live before writing it?

When that criterion does not exist, the placement of each new endpoint ends up depending on intuition, precedent, or negotiation among developers. The result is usually an API tree that works at first, but becomes increasingly difficult to navigate and maintain.