Casi d'uso di API Gateway

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

La seguente sezione sui casi d'uso presenta una panoramica dei diversi tipi di API Gateway APIs e dei diversi tipi di sviluppatori che utilizzano API Gateway. Per informazioni più dettagliate sulla differenza tra REST APIs e HTTP APIs, consultaScegli tra REST APIs e HTTP APIs.

Usa API Gateway per creare REST APIs

Un'API REST API Gateway include risorse e metodi. Una risorsa è un'entità logica a cui un'app può accedere tramite un percorso della risorsa. Un metodo corrisponde a una richiesta API REST inviata dall'utente della tua API e alla risposta restituita all'utente.

Ad esempio, /incomes potrebbe essere il percorso di una risorsa che rappresenta il reddito dell'utente dell'app. Una risorsa può avere una o più operazioni definite dai verbi HTTP adeguati, come GET, POST, PUT, PATCH e DELETE. La combinazione tra percorso della risorsa e operazione identifica un metodo dell'API. Ad esempio, un metodo POST /incomes potrebbe aggiungere il reddito guadagnato dall'intermediario, mentre il metodo GET /expenses potrebbe eseguire una query relativa alle spese indicate sostenute dall'intermediario.

Non è necessario che l'app sappia dove i dati vengono archiviati e prelevati sul back-end. In API Gateway REST APIs, il frontend è incapsulato da richieste di metodo e risposte di metodo. L'API si interfaccia con il back-end tramite le richieste di integrazione e le risposte di integrazione.

Ad esempio, con DynamoDB come back-end, lo sviluppatore di API configura la richiesta di integrazione per inoltrare la richiesta di metodo in entrata al back-end scelto. La configurazione include le specifiche di un'operazione DynamoDB adeguata, i ruoli e le policy IAM richiesti e la trasformazione necessaria dei dati di input. Il back-end restituisce il risultato ad API Gateway come risposta di integrazione.

Per instradare la risposta di integrazione a una risposta di metodo appropriata (di un determinato codice di stato HTTP) al client, puoi configurare la risposta di integrazione per mappare i parametri di risposta richiesti dall'integrazione al metodo. Quindi puoi trasformare il formato dei dati di output del back-end nel formato del front-end, se necessario. API Gateway consente di definire uno schema o modello per il payload per agevolare la configurazione del modello di mappatura del corpo.

API Gateway fornisce le funzionalità di gestione delle API REST, ad esempio la seguente:

Usa API Gateway per creare HTTP APIs

HTTP ti APIs consente di creare RESTful APIs con una latenza inferiore e un costo inferiore rispetto a APIs REST.

È possibile utilizzare HTTP APIs per inviare richieste a AWS Lambda funzioni o a qualsiasi endpoint HTTP instradabile pubblicamente.

Ad esempio, puoi creare un'API HTTP che si integra con una funzione Lambda sul back-end. Quando un client chiama l'API, API Gateway invia la richiesta alla funzione Lambda e restituisce la risposta della funzione al client.

APIs Supporto HTTP OpenID Connect e autorizzazione OAuth 2.0. Sono dotate di supporto integrato per CORS (cross-origin resource sharing) e le distribuzioni automatiche.

Per ulteriori informazioni, consulta Scegli tra REST APIs e HTTP APIs.

Usa API Gateway per creare WebSocket APIs

In un' WebSocket API, il client e il server possono scambiarsi messaggi in qualsiasi momento. I server di back-end possono eseguire facilmente il push dei dati agli utenti e ai dispositivi connessi, evitando la necessità di implementare complessi meccanismi di polling.

Ad esempio, è possibile creare un'applicazione serverless utilizzando un'API WebSocket API Gateway e AWS Lambda inviare e ricevere messaggi da e verso singoli utenti o gruppi di utenti in una chat room. Oppure puoi richiamare servizi di backend come AWS Lambda Amazon Kinesis o un endpoint HTTP basato sul contenuto dei messaggi.

Puoi utilizzare API Gateway WebSocket APIs per creare applicazioni di comunicazione sicure e in tempo reale senza dover fornire o gestire server per gestire connessioni o scambi di dati su larga scala. I casi d'uso di riferimento includono applicazioni in tempo reale come le seguenti:

API Gateway offre funzionalità di gestione delle WebSocket API come le seguenti:

Chi utilizza le API Gateway?

Esistono due tipi di sviluppatori che utilizzano API Gateway: gli sviluppatori di API e gli sviluppatori di app.

Uno sviluppatore di API crea e distribuisce un'API per abilitare la funzionalità richiesta in API Gateway. Lo sviluppatore dell'API deve essere un utente dell' AWS account proprietario dell'API.

Uno sviluppatore di app crea un'applicazione funzionante per chiamare AWS i servizi richiamando un' WebSocket API REST creata da uno sviluppatore di API in API Gateway.

Lo sviluppatore di app è il cliente dello sviluppatore di API. Lo sviluppatore dell'app non deve disporre di un AWS account, a condizione che l'API non richieda autorizzazioni IAM o supporti l'autorizzazione degli utenti tramite provider di identità federati di terze parti supportati dalla federazione delle identità dei pool di utenti di Amazon Cognito. Tra i provider di identità figurano Amazon, pool di utenti Amazon Cognito, Facebook e Google.

Creazione e gestione di un'API di API Gateway

Uno sviluppatore di API lavora con la componente del servizio API Gateway per la gestione delle API, denominata apigateway, per creare, configurare e distribuire un'API.

In qualità di sviluppatore di API, puoi creare e gestire un'API utilizzando la console API Gateway, descritta in Nozioni di base su Gateway API o chiamando il Riferimenti API. Sono disponibili diversi modi per chiamare questa API. Includono l'utilizzo di AWS Command Line Interface (AWS CLI) o l'utilizzo di un SDK. AWS Inoltre, puoi abilitare la creazione di API con AWS CloudFormation modelli o (nel caso di REST APIs e HTTP APIs)Estensioni OpenAPI per Gateway API.

Per un elenco di regioni in cui API Gateway è disponibile, compresi gli endpoint del servizio di controllo associati, consulta Endpoint e quote Amazon API Gateway.

Chiamare un'API di API Gateway

Uno sviluppatore di app lavora con la componente del servizio API Gateway per l'esecuzione dell'API, denominata execute-api, per chiamare un'API creata o distribuita in API Gateway. Le entità di programmazione sottostanti vengono esposte dall'API creata. Sono disponibili diversi modi per chiamare questa API. Per ulteriori informazioni, consulta Richiama REST APIs in API Gateway e Invoca WebSocket APIs.