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à.

APICasi d'uso del gateway

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 HTTPAPIs, vedereScegli tra REST APIs e HTTP APIs.

Usa API Gateway per creare REST APIs

Un API gateway REST API è composto da risorse e metodi. Una risorsa è un'entità logica a cui un'app può accedere tramite un percorso della risorsa. Un metodo corrisponde a una REST API richiesta inviata dall'utente dell'utente 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 da HTTP verbi appropriati come GETPOST, PUTPATCH, eDELETE. Una combinazione di un percorso di risorsa e un'operazione identifica un metodo di. 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 RESTAPIs, il frontend è incapsulato dalle richieste di metodo e dalle risposte dei metodi. Le API interfacce con il backend mediante richieste di integrazione e risposte di integrazione.

Ad esempio, con DynamoDB come backend, API lo sviluppatore imposta la richiesta di integrazione per inoltrare la richiesta del metodo in entrata al backend scelto. La configurazione include le specifiche di un'azione DynamoDB appropriata, il ruolo e le politiche IAM richiesti e la trasformazione dei dati di input richiesta. Il backend restituisce il risultato a API Gateway come risposta di integrazione.

Per indirizzare la risposta di integrazione a una risposta del metodo appropriata (di un determinato codice di HTTP stato) 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. APIGateway consente di definire uno schema o un modello per il payload per facilitare la configurazione del modello di body mapping.

APIGateway offre funzionalità di REST API gestione come le seguenti:

Usa API Gateway per creare HTTP APIs

HTTPAPIsconsentono di creare RESTful APIs con una latenza inferiore e costi inferiori rispetto a RESTAPIs.

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

Ad esempio, puoi creare un file HTTP API che si integri con una funzione Lambda sul backend. Quando un client chiama il tuoAPI, API Gateway invia la richiesta alla funzione Lambda e restituisce la risposta della funzione al client.

HTTPAPIssupporta l'autorizzazione OpenID Connect e OAuth2.0. Sono dotati di supporto integrato per la condivisione di risorse tra origini diverse (CORS) e le distribuzioni automatiche.

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

Usa API Gateway per creare WebSocket APIs

In a 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 gateway WebSocket API 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 HTTP un endpoint 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:

APIGateway offre funzionalità di WebSocket API gestione come le seguenti:

Chi utilizza API Gateway?

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

Uno API sviluppatore crea e distribuisce un file API per abilitare le funzionalità richieste in API Gateway. Lo API sviluppatore deve essere un utente dell' AWS account proprietario diAPI.

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

Lo sviluppatore dell'app è il cliente dello API sviluppatore. Lo sviluppatore dell'app non deve disporre di un AWS account, a condizione che non richieda IAM autorizzazioni o supporti l'APIautorizzazione 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 gateway API API

Uno API sviluppatore utilizza il componente del servizio API Gateway per la API gestioneapigateway, denominato, per creare, configurare e distribuire unAPI.

In qualità di API sviluppatore, puoi creare e gestire un file API utilizzando la console API Gateway, descritta inInizia a usare API Gateway, o chiamando ilRiferimenti API. Esistono diversi modi per chiamarloAPI. Includono l'utilizzo di AWS Command Line Interface (AWS CLI) o l'utilizzo di un AWS SDK. Inoltre, puoi abilitare API la creazione con AWS CloudFormation modelli o (nel caso di REST APIs e HTTPAPIs)APIEstensioni aperte per API Gateway.

Per un elenco delle regioni in cui API Gateway è disponibile, nonché gli endpoint del servizio di controllo associati, consulta Amazon API Gateway Endpoints and Quotas.

Chiamata di un gateway API API

Uno sviluppatore di app utilizza il componente del servizio API Gateway for API Executionexecute-api, denominato, per richiamare un API componente creato o distribuito in API Gateway. Le entità di programmazione sottostanti vengono esposte dal creato. API Esistono diversi modi per chiamarloAPI. Per ulteriori informazioni, consultare Richiama le API REST in API Gateway e Richiama le API WebSocket .