Contract First o Morir en el Intento: La Única Forma Sensata de Diseñar APIs

Necesito desahogarme. Algo que ha estado pudriéndose en mi alma desde la primera vez que me uní a un proyecto a mitad de desarrollo y hice la pregunta fatídica: “¿Dónde está la documentación de la API?”

La respuesta, invariablemente, era una de las siguientes:

1. “Revisa la colección de Postman.” (Traducción: un cementerio de 200 peticiones, la mitad desactualizadas, con nombres como GET users FINAL v2 (copia))
2. “Simplemente mira el código.” (Traducción: haz ingeniería inversa de nuestro espagueti y buena suerte)
3. “La documentaremos más tarde.” (Traducción: nunca la documentaremos)