API pratiche per l'IA e la scienza dei dati

Capitolo 2. Scegliere l'architettura dell'API

Questo lavoro è stato tradotto utilizzando l'AI. Siamo lieti di ricevere il tuo feedback e i tuoi commenti: [e-mail]

Le città felici sono quelle che hanno un'architettura.

Le Corbusier, Verso una nuova architettura (Dover Publications, 1965)

Nel Capitolo 1 hai iniziato il tuo progetto di portfolio comprendendo le esigenze degli utenti e selezionando i casi d'uso da soddisfare. Questo lavoro iniziale è fondamentale per assicurarti di costruire i prodotti giusti per soddisfare le esigenze reali dei clienti. In questo capitolo inizierai a sviluppare l'architettura che userai per costruire le tue prime API.

Stili architettonici API

Una delle decisioni più significative che deve prendere è la scelta dello stile architettonico dell'API da utilizzare. Dal momento che stai utilizzando un processo di progettazione incentrato sul consumatore, ne consegue che uno dei tuoi primi obiettivi è quello di utilizzare uno stile che sia ampiamente supportato e compreso dai potenziali consumatori. Il Postman 2023 State of the API Report ha rilevato che questi sono i sei principali stili architetturali delle API:

• REST: 86%

• Webhooks: 36%

• GraphQL: 29%

• Protocollo di accesso agli oggetti semplici (SOAP): 26%

• WebSockets: 25%

• gRPC: 11%

La popolarità schiacciante di REST riscontrata nel sondaggio è coerente con quanto si riscontra esplorando la maggior parte delle API pubbliche. REST è attualmente lo stile tipico utilizzato ...