Vivim en una era d’excés digital on s’ensenya als desenvolupadors a creure que l’objectiu d’una API és servir dades. Aquest és un error fonamental que ha costat milers de milions en infraestructura i seguretat arreu del món. Hem passat anys debatent REST contra GraphQL o gRPC contra WebSockets i ens hem oblidat de mirar la solució més elegant i rendible que existeix. Parlo del concepte de No com a Servei o NaaS (https://github.com/hotheadhacker/no-as-a-service).
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)