Quali sono i principi di un'interfaccia unificata?

Principi di interfaccia unificata (noti anche come principi di progettazione API RESTful, anche se applicabili ad altri sistemi distribuiti):

1. Identificazione delle risorse: Ogni parte dell'informazione indirizzabile deve avere un identificatore univoco. Il client interagisce con le risorse utilizzando questi identificatori.
2. Manipolazione delle risorse tramite rappresentazioni: Il client riceve una rappresentazione della risorsa (ad esempio in formato JSON o XML) e può modificare lo stato della risorsa inviando la rappresentazione modificata al server.
3. Messaggi auto-descrittivi: Ogni messaggio tra client e server deve contenere informazioni sufficienti per la sua interpretazione completa. Il client non dovrebbe fare affidamento su informazioni esterne o sullo stato della sessione sul server.
4. Hypermedia come motore di stato dell'applicazione (HATEOAS - Hypermedia As The Engine Of Application State): Il server dovrebbe fornire link ipermediali nelle risposte che indicano le azioni possibili successive o risorse correlate. Il client naviga nell'applicazione seguendo questi link, invece di fare affidamento su URL fissi o logica predefinita.
5. Architettura client-server: Separazione chiara delle responsabilità tra client (che gestisce l'interfaccia utente e avvia le richieste) e server (che memorizza i dati e processa le richieste). Questa separazione migliora la scalabilità e la portabilità del client.
6. Senza stato (Stateless): Ogni richiesta del client al server deve contenere tutte le informazioni necessarie affinché il server possa comprenderla e processarla. Il server non mantiene informazioni sullo stato della sessione del client tra le richieste. Ciò aumenta la scalabilità e la resilienza ai guasti.

Il rispetto di questi principi contribuisce a creare sistemi distribuiti scalabili, flessibili e facili da mantenere.