Cos'è una REST API?

Una REST API è un'interfaccia che espone risorse tramite HTTP, utilizzando un piccolo insieme di verbi e schemi di URL prevedibili. REST, abbreviazione di Representational State Transfer, è uno stile architetturale più che un protocollo rigido, ma la pratica comune di usare GET, POST, PUT, PATCH e DELETE contro gli URL delle risorse è diventata il modo predefinito per integrare i servizi web.

Definizione

In un tipico design REST, ogni risorsa ha il proprio URL, e le operazioni sulla risorsa corrispondono ai verbi HTTP. Un prodotto potrebbe risiedere in /products/123, recuperabile con GET, modificabile con PATCH e rimovibile con DELETE. Le risposte sono di solito in JSON, i codici di stato segnalano gli esiti e gli header trasportano metadati come direttive di caching e token di autenticazione.

Perché è importante

Le REST API sono la lingua franca degli stack di commerce moderni. Sistemi PIM, OMS, provider di pagamento, motori di ricerca e piattaforme di contenuto espongono endpoint REST che vetrine e livelli di integrazione consumano. La loro semplicità, l'ampio supporto degli strumenti e la semantica HTTP esplicita le rendono particolarmente adatte alle integrazioni pubbliche.

REST vs GraphQL

REST eccelle in interazioni chiare e orientate alle risorse e beneficia del caching HTTP nativo. GraphQL eccelle nelle letture flessibili, dove è il client a decidere la forma della risposta. In pratica, la maggior parte degli stack di composable commerce combina entrambi: REST per l'integrazione da servizio a servizio e i webhook, GraphQL o BFF per il frontend. La scelta dipende dalle competenze del team, dall'ecosistema e da quanto prevedibili siano le esigenze del client.

Correlati

Scopri Composable Digital Experience Platform · Composable Headless Frontend.