También disponible en inglés

Antes de diseñar un endpoint, clasificá su naturaleza. Recién después elegí su ubicación.

El problema silencioso

Existen muchos artículos que explican cómo escribir una API REST. Aquí, en cambio, nos vamos a centrar en una pregunta previa: ¿cómo decidir dónde debe vivir un endpoint antes de escribirlo?

Cuando ese criterio no existe, la ubicación de cada nuevo endpoint termina dependiendo de la intuición, del precedente o de una negociación entre desarrolladores. El resultado suele ser un árbol de APIs que funciona al principio, pero que se vuelve cada vez más difícil de navegar y mantener.