Best practice per API in evoluzione
Mercoledì 11 Gennaio 2012 - 10:15
di Alessandro Nadalin
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.
Categoria: Web Standards | Permalink