Microsoft REST API Guidelines
Lo scorso 8 Luglio ho partecipato ad una giornata interamente dedicata ad ASP.NET Core 1.0, evento organizzato da Overnet Education, e portato a termine da Gabriele Gaggi ed Ugo Lattanzi. In quel frangente ovviamente si parlava di web, controller, web api, e via dicendo. Ricordo che Ugo ad un certo punto disse una cosa simile alla seguente: “secondo la convenzione, quando si invoca un metodo REST che aggiunge un oggetto al nostro repository, la response deve includere almeno due informazioni: l’ID dell’elemento appena aggiunto e l’URL al quale si possono reperire i dettagli dell’elemento stesso”. Scusate l’imprecisione, ma il web non è propriamente il mio campo. Ricordo di aver trovato interessante quell’affermazione di Ugo, al punto che lo interruppi chiedendogli…ma dove posso trovare queste regole, convenzioni, buone norme di implementazione di API di tipo REST?
Beh, oggi la risposta ce l’ho.
Su GitHub Microsoft ha pubblicato un repository denominato “Microsoft REST API Guidelines” ricco di documentazione, allo scopo di fornire a tutti gli sviluppatori le migliori guideline per l’implementazione di API REST. Tra gli autori figura un certo Mark Russinovich. Troverete informazioni su un po’ tutto: gestione degli errori, struttura degli URL, serializzazione in JSON, gestione corretta del versioning delle API, e molto altro ancora.
Sono piuttosto certo che troverete la lettura molto interessante!
Send to Kindle