Costruire una REST API che non faccia schifo è un’arte sottile. È come servire whisky d’annata in un bicchiere di plastica: anche se il contenuto è buono, l’esperienza crolla. E in un’era in cui ogni microservizio, SaaS o IoT toaster parla con un altro pezzo di software, la tua API è l’interfaccia diplomatica del tuo sistema. Mal progettata, diventa una dichiarazione di guerra.
Cominciamo da un classico che sembra semplice ma viene ignorato come le istruzioni del microonde: gli HTTP status code. Non è una tavolozza a caso. Restituire 200 OK per ogni chiamata è l’equivalente digitale di annuire mentre ti sparano. Se il client sbaglia, diglielo con un 400. Se sei tu a esplodere, abbi il coraggio di un 500. Non mascherare il malfunzionamento con falsi successi, o ti ritroverai con un client che balla sul Titanic.