Contract First o Muori Provandoci: L’Unico Modo Sano di Progettare API

Devo sfogarmi. Qualcosa che mi rode l’anima dalla prima volta che mi sono unito a un progetto a metà sviluppo e ho posto la fatidica domanda: “Dov’è la documentazione dell’API?”

La risposta, invariabilmente, era una delle seguenti:

1. “Controlla la collection di Postman.” (Traduzione: un cimitero di 200 richieste, metà delle quali obsolete, chiamate cose come GET users FINAL v2 (copy))
2. “Guarda semplicemente il codice.” (Traduzione: reverse-engineer il nostro spaghetti e buona fortuna)
3. “La documenteremo più tardi.” (Traduzione: non la documenteremo mai)