Benjamin Carlyle, già citato per i suoi studi all'interno di REST in practice, propone un interessante post con consigli di design per API HTTP che puntino all'evolvibilità .
Sono infatti 21 le best practice che Benjamin propone nello sviluppo di API HTTP, alcune banali (URI che cambiano mantenendo la stessa semantica e con reindirizzamenti dalle vecchie alle nuove) ed altre meno (utilizzo del 501 quando uno dei metodi richiesti dai clienti non è implementato).
Vengono proposte linee guida a problemi troppo spesso affrontati con soluzioni diverse (regola 9: utilizzare gli header per la verbosità negli errori) e delineate delle regole di base troppo spesso ignorate nello sviluppo di API (regole 13 e 14: informare sempre client/server dei media type che vengono supportati).
Il canovaccio tracciato da Benjamin sembra chiaro e schietto e siamo sicuri che tracciare una linea, a mà di cookbook, possa servire a molti novizi in termini di API ed in termini di protocollo HTTP.
/https://www.html.it/app/uploads/2023/09/DevToys.png)
/https://www.html.it/app/uploads/2009/01/server.png)
/https://www.html.it/app/uploads/2019/06/firefox-1.jpg)
/https://www.html.it/app/uploads/2018/01/power_battery-1.jpg)