Contract First o Morir en el Intento: La Única Forma Sensata de Diseñar APIs
Necessito descarregar alguna cosa del pit. Alguna cosa que ha estat festerant a la meva ànima des de la primera vegada que em vaig unir a un projecte a mitjan desenvolupament i vaig fer la pregunta fatídica: “On està la documentació de l’API?”
La resposta, invariablement, era una de les següents:
- “Mira la col·lecció de Postman.” (Traducció: un cementiri de 200 peticions, la meitat de les quals estan desactualitzades, anomenades coses com
GET users FINAL v2 (còpia)) - “Simplement mira el codi.” (Traducció: reverse-engineer la nostra espagueti i bona sort)
- “La documentarem més tard.” (Traducció: mai la documentarem)
