Cos'è un'API REST?

REST API è uno stile architettonico, non uno standard, per costruire sistemi distribuiti. Si basa su principi come l'assenza di stato, architettura client-server e l'uso di metodi HTTP standard (GET, POST, PUT, DELETE, PATCH) per operazioni sulle risorse.

Principi chiave di REST:

• Stateless (senza stato): Il server non memorizza informazioni sullo stato del client tra le richieste. Ogni richiesta contiene tutte le informazioni necessarie per l'elaborazione.
• Client-Server: Separazione chiara tra client e server. Ognuno può evolversi indipendentemente.
• Cacheable: Le risposte possono essere contrassegnate come cacheabili o non cacheabili, migliorando le prestazioni.
• Sistema a strati: Il client non può sapere se è connesso direttamente al server o tramite strati intermedi.
• Interfaccia uniforme: Modi standardizzati di interagire con le risorse. Include:
  • Identificazione delle risorse (URI)
  • Manipolazione delle risorse tramite rappresentazioni
  • Messaggi auto-descrittivi
  • Hypermedia come motore dello stato dell'applicazione (HATEOAS) - lo stato dell'applicazione è gestito tramite hyperlink.

Esempio di utilizzo dei metodi HTTP standard:

Metodo HTTP	Azione sulla risorsa (ad esempio, /users)	Descrizione
GET	/users o /users/{id}	Ottenere la lista degli utenti o un utente specifico.
POST	/users	Creare un nuovo utente.
PUT	/users/{id}	Aggiornamento completo dei dati dell'utente tramite il suo ID.
PATCH	/users/{id}	Aggiornamento parziale dei dati dell'utente tramite il suo ID.
DELETE	/users/{id}	Eliminare l'utente tramite il suo ID.

REST API viene utilizzata per l'interazione tra diversi sistemi e applicazioni, ad esempio tra frontend e backend.