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à. # Scelta di un tutorial per l'integrazione HTTP Per creare un'API con l'integrazione HTTP, è possibile utilizzare l'integrazione proxy HTTP o l'integrazione personalizzata HTTP. Per l'integrazione proxy HTTP, è necessario solo impostare il metodo HTTP e l'URI dell'endpoint HTTP, in base ai requisiti del backend. Si consiglia, se possibile, di utilizzare l'integrazione proxy HTTP per semplificare la configurazione dell'API. L'integrazione personalizzata HTTP può risultare utile se è necessario trasformare i dati delle richieste client per il backend o i dati delle risposte del backend per il client. **Topics** + [ # Tutorial: creazione di una REST API con l'integrazione proxy HTTP ](api-gateway-create-api-as-simple-proxy-for-http.md) + [ # Tutorial: creazione di una REST API con un'integrazione non proxy HTTP ](api-gateway-create-api-step-by-step.md) # Tutorial: creazione di una REST API con l'integrazione proxy HTTP L'integrazione proxy HTTP è un meccanismo semplice, potente e versatile per creare un'API che permetta a un'applicazione Web di accedere a più caratteristiche o risorse dell'endpoint HTTP integrato, ad esempio l'intero sito Web, con una configurazione semplificata di un solo metodo API. In un'integrazione proxy HTTP, API Gateway passa la richiesta di metodo inviata dal client al back-end. I dati di richiesta che vengono passati includono intestazioni di richiesta, parametri delle stringhe di query, variabili di percorso URL e payload. L'endpoint HTTP di back-end o il server Web analizza i dati delle richieste in ingresso per stabilire la risposta da restituire. L'integrazione proxy HTTP consente l'interazione diretta tra client e back-end senza alcun intervento da parte di API Gateway dopo la configurazione del metodo API, tranne nel caso di problemi noti elencati in , ad esempio caratteri non supportat [Note importanti Amazon API Gateway](api-gateway-known-issues.md). Con la risorsa proxy globale `{proxy+}` e il verbo catch-all `ANY` per il metodo HTTP, puoi usare un'integrazione proxy HTTP per creare un'API di un metodo API singolo. Il metodo espone l'intero set di operazioni e risorse HTTP accessibili pubblicamente di un sito Web. Quando il server Web di back-end apre più risorse per l'accesso pubblico, il client può usare le nuove risorse con la stessa configurazione API. Per consentirlo, lo sviluppatore del sito Web deve comunicare chiaramente con lo sviluppatore del client in merito alla natura delle nuove risorse e alle operazioni applicabili per ciascuna di esse. Come breve introduzione, il tutorial che segue fornisce un esempio di integrazione proxy HTTP. Nel tutorial, creiamo un'API utilizzando la console API Gateway per l'integrazione con il PetStore sito Web tramite una risorsa `{proxy+}` proxy generica e creiamo il segnaposto del metodo HTTP di. `ANY` **Topics** + [ ## Creazione di un'API con l'integrazione proxy HTTP mediante la console API Gateway ](#api-gateway-create-api-as-simple-proxy-for-http-build) + [ ## Verifica di un'API con l'integrazione proxy HTTP ](#api-gateway-create-api-as-simple-proxy-for-http-test) ## Creazione di un'API con l'integrazione proxy HTTP mediante la console API Gateway Nella procedura seguente vengono descritte le fasi necessarie per creare e testare un'API con una risorsa proxy per un back-end HTTP mediante la console API Gateway. Il back-end HTTP è il sito Web `PetStore` (`http://petstore-demo-endpoint.execute-api.com/petstore/pets`) da [Tutorial: creazione di una REST API con un'integrazione non proxy HTTP](api-gateway-create-api-step-by-step.md), in cui vengono usati screenshot come supporto visivo per illustrare gli elementi dell'interfaccia utente API Gateway. Se non hai esperienza di utilizzo della console API Gateway per la creazione di un'API, può essere di aiuto seguire prima tale sezione. **Come creare un’API** 1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway) 1. Se si utilizza API Gateway per la prima volta, verrà visualizzata una pagina che presenta le caratteristiche del servizio. In **API REST**, scegliere **Crea**. Quando appare il popup **Create Example API (Crea API di esempio)**, scegliere **OK**. Se non è la prima volta che si utilizza API Gateway, scegliere **Create API (Crea API)**. In **API REST**, scegliere **Crea**. 1. Per **API name (Nome API)**, immettere **HTTPProxyAPI**. 1. (Facoltativo) In **Descrizione**, immetti una descrizione. 1. Lasciare l'opzione **Tipo di endpoint API** impostata su **Regionale**. 1. Per il tipo di **indirizzo IP**, selezionare. **IPv4** 1. Seleziona **Create API** (Crea API). In questa fase crei un percorso della risorsa proxy di `{proxy+}`. Questo è il segnaposto di un endpoint di back-end in `http://petstore-demo-endpoint.execute-api.com/`. Ad esempio, può essere `petstore`, `petstore/pets` e `petstore/pets/{petId}`. Quando crei la risorsa `{proxy+}`, Gateway API crea il metodo `ANY` che funge da segnaposto per qualsiasi verbo HTTP supportato al runtime. **Per creare una risorsa **/\$1proxy\$1\$1**** 1. Scegliere l'API. 1. Nel riquadro di navigazione principale scegli **Risorse**. 1. Scegli **Crea risorsa**. 1. Attiva **Risorsa proxy**. 1. Mantieni **Percorso risorsa** impostato su `/`. 1. Per **Resource Name (Nome risorsa)** immetti **\$1proxy\$1\$1**. 1. Mantieni **CORS (Cross Origin Resource Sharing)** disattivato. 1. Scegli **Crea risorsa**. ![\[Creazione di una risorsa figlio.\]](http://docs.aws.amazon.com/it_it/apigateway/latest/developerguide/images/api-gateway-simple-proxy-create-proxy-resource-new-console.png) In questa fase integri il metodo `ANY` con un endpoint HTTP di back-end, utilizzando un'integrazione proxy. In un'integrazione proxy, Gateway API passa la richiesta del metodo inviata dal client al back-end senza intervento di Gateway API. **Per creare un metodo `ANY`** 1. Scegli la risorsa **/\$1proxy\$1\$1**. 1. Scegli il metodo **ANY**. 1. Sotto il simbolo di avviso, scegli **Modifica integrazione**. Non puoi implementare un'API con un metodo senza un'integrazione. 1. Per **Tipo di integrazione** seleziona **HTTP**. 1. Attiva l'opzione **Integrazione proxy HTTP**. 1. Per **Metodo HTTP** seleziona **ANY**. 1. Per **URL dell'endpoint** immetti **http://petstore-demo-endpoint.execute-api.com/\$1proxy\$1**. 1. Scegli **Save** (Salva). ## Verifica di un'API con l'integrazione proxy HTTP L'esito di una richiesta client specifica dipende dagli elementi seguenti: + Se il back-end ha reso disponibile l'endpoint di back-end corrispondente e, in caso affermativo, se ha concesso le autorizzazioni di accesso richieste. + Se il client fornisce l'input corretto. Ad esempio, l' PetStore API utilizzata qui non espone la `/petstore` risorsa. In questo modo, ottieni una risposta `404 Resource Not Found` contenente il messaggio di errore `Cannot GET /petstore`. Inoltre per analizzare correttamente il risultato, il client deve essere in grado di gestire il formato di output del back-end. API Gateway non svolge alcuna mediazione per semplificare le interazioni tra il client e il back-end. **Per testare un'API integrata con il PetStore sito Web utilizzando l'integrazione del proxy HTTP tramite la risorsa proxy** 1. Seleziona la scheda **Test**. Potrebbe essere necessario scegliere il pulsante freccia destra per visualizzare la scheda. 1. In **Tipo di metodo**, seleziona `GET`. 1. In **Percorso** immetti **petstore/pets** per **proxy**. 1. In **Stringhe di query** immetti **type=fish**. 1. Scegli **Test (Esegui test)**. ![\[Utilizza la funzionalità Test per eseguire il test del metodo.\]](http://docs.aws.amazon.com/it_it/apigateway/latest/developerguide/images/api-gateway-simple-proxy-petstore-call-proxy-resource-new-console.png) Poiché supporta la richiesta `GET /petstore/pets?type=fish`, il sito Web di back-end restituisce una risposta con esito positivo simile alla seguente: ``` [ { "id": 1, "type": "fish", "price": 249.99 }, { "id": 2, "type": "fish", "price": 124.99 }, { "id": 3, "type": "fish", "price": 0.99 } ] ``` Se provi a chiamare `GET /petstore`, ottieni una risposta `404` con il messaggio di errore `Cannot GET /petstore`. Questo perché il back-end non supporta l'operazione specificata. Se chiami`GET /petstore/pets/1`, riceverai una `200 OK` risposta con il seguente payload, poiché la richiesta è supportata dal PetStore sito Web. ``` { "id": 1, "type": "dog", "price": 249.99 } ``` Puoi anche utilizzare un browser per testare l'API. Implementa l'API e associala a una fase per creare l'URL di richiamata dell'API. **Per distribuire l'API** 1. Seleziona **Deploy API (Distribuisci API)**. 1. In **Fase**, seleziona **Nuova fase**. 1. In **Stage name (Nome fase)** immettere **test**. 1. (Facoltativo) In **Descrizione**, immetti una descrizione. 1. Seleziona **Implementa**. Ora i client possono chiamare la tua API. **Richiamo dell'API** 1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway) 1. Scegliere l'API. 1. Nel pannello di navigazione principale scegli **Fase**. 1. In **Dettagli fase**, scegli l'icona Copia per copiare l'URL di richiamo dell'API. Immetti l'URL di richiamata dell'API in un browser Web. L'URL completo dovrebbe essere del tipo `https://abcdef123.execute-api.us-east-2.amazonaws.com/test/petstore/pets?type=fish`. Il tuo browser invia una richiesta `GET` all'API. 1. Il risultato sarà uguale a quello che viene restituito quando si usa **Test** nella console Gateway API. # Tutorial: creazione di una REST API con un'integrazione non proxy HTTP In questo tutorial viene creata un'API da zero utilizzando la console Amazon API Gateway. Puoi pensare alla console come a uno studio di progettazione delle API e utilizzarla per analizzare le caratteristiche delle API, sperimentare i loro comportamenti, crearle e poi distribuirle per fasi. **Topics** + [ ## Creazione di un'API con l'integrazione personalizzata HTTP ](#api-gateway-create-resource-and-methods) + [ ## (Facoltativo) Mappatura dei parametri di richiesta ](#api-gateway-create-resources-and-methods-next-steps) ## Creazione di un'API con l'integrazione personalizzata HTTP Questa sezione illustra per fasi come creare le risorse, esporre i metodi su una risorsa, configurare un metodo per ottenere i comportamenti dell'API desiderati, testar e distribuire le API. In questa fase si crea un'API vuota. Nelle seguenti fasi crei risorse e metodi per connettere l'API all'endpoint `http://petstore-demo-endpoint.execute-api.com/petstore/pets`, utilizzando un'integrazione HTTP non proxy. **Come creare un’API** 1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway) 1. Se si utilizza API Gateway per la prima volta, verrà visualizzata una pagina che presenta le caratteristiche del servizio. In **API REST**, scegliere **Crea**. Quando appare il popup **Create Example API (Crea API di esempio)**, scegliere **OK**. Se non è la prima volta che si utilizza API Gateway, scegliere **Create API (Crea API)**. In **API REST**, scegliere **Crea**. 1. Per **API name (Nome API)**, immettere **HTTPNonProxyAPI**. 1. (Facoltativo) In **Descrizione**, immetti una descrizione. 1. Lasciare l'opzione **Tipo di endpoint API** impostata su **Regionale**. 1. Per il tipo di **indirizzo IP**, selezionare. **IPv4** 1. Seleziona **Create API** (Crea API). L'albero **Resources (Risorse)** mostra la risorsa root (`/`) senza metodi. In questo esercizio, creeremo l'API con l'integrazione personalizzata HTTP del PetStore sito Web (http://petstore-demo-endpoint.execute-api. com/petstore/pets.) A scopo illustrativo, creeremo una `/pets` risorsa come elemento secondario della radice e mostreremo un metodo GET su questa risorsa per consentire a un cliente di recuperare un elenco di articoli Pets disponibili dal sito Web. PetStore **Per creare una risorsa /pets** 1. Scegli **Crea risorsa**. 1. Mantieni l'opzione **Risorsa proxy** disattivata. 1. Mantieni **Percorso risorsa** impostato su `/`. 1. Per **Resource Name (Nome risorsa)** immetti **pets**. 1. Mantieni **CORS (Cross Origin Resource Sharing)** disattivato. 1. Scegli **Crea risorsa**. In questa fase crei un metodo `GET` per la risorsa **/pets**. Il metodo `GET` è integrato con il sito Web `http://petstore-demo-endpoint.execute-api.com/petstore/pets`. Altre opzioni per il metodo API sono: + **POST**, usato principalmente per creare risorse figlio. + **PUT**, utilizzato principalmente per aggiornare risorse esistenti (e, sebbene non consigliato, può essere usato per creare risorse figlio). + **DELETE**, utilizzato per eliminare le risorse. + **PATCH**, utilizzato per aggiornare le risorse. + **HEAD**, utilizzato principalmente negli scenari di test. È lo stesso di GET ma non restituisce la rappresentazione della risorsa. + **OPTIONS**, che può essere utilizzato dagli intermediari per ricevere informazioni sulle opzioni di comunicazione disponibili per il servizio di destinazione. Per **HTTP method (Metodo HTTP)** della richiesta di integrazione, occorre selezionarne uno supportato dal back-end. Per `HTTP` o `Mock integration`, è opportuno che la richiesta di metodo e la richiesta di integrazione utilizzino lo stesso verbo HTTP. Per altri tipi di integrazione, la richiesta di metodo utilizzerà probabilmente un verbo HTTP diverso da quello della richiesta di integrazione. Ad esempio, per chiamare una funzione Lambda, la richiesta di integrazione deve utilizzare `POST` per invocare la funzione, mentre la richiesta di metodo potrebbe utilizzare qualsiasi verbo HTTP in base alla logica della funzione Lambda. **Per creare un metodo `GET` nella risorsa **/pets**** 1. Seleziona la risorsa **/pets**. 1. Scegli **Crea metodo**. 1. Per **Tipo di metodo** seleziona **GET**. 1. Per **Tipo di integrazione** seleziona **Integrazione HTTP**. 1. Mantieni l'opzione **Integrazione proxy HTTP** disattivata. 1. Per **Metodo HTTP** seleziona **GET**. 1. Per **URL dell'endpoint** immetti **http://petstore-demo-endpoint.execute-api.com/petstore/pets**. Il PetStore sito Web consente di recuperare un elenco di `Pet` elementi in base al tipo di animale domestico, ad esempio «Cane» o «Gatto», in una determinata pagina. 1. Per **Gestione contenuti** seleziona **Transito**. 1. Scegli **Parametri della stringa di query URL**. Il PetStore sito Web utilizza `type` i parametri della stringa di `page` interrogazione per accettare un input. Aggiungi i parametri della stringa di query alla richiesta del metodo e mappali nei parametri della stringa di query corrispondenti della richiesta di integrazione. 1. Per aggiungere i parametri della stringa di query, procedi come indicato di seguito: 1. Scegliere **Add query string (Aggiungi stringa di query)**. 1. Per **Nome** immetti **type**. 1. Mantieni **Obbligatorio** e **Caching** disattivati. Ripeti le fasi precedenti per creare una stringa di query aggiuntiva denominata **page**. 1. Scegli **Crea metodo**. Se invii una richiesta, ora il client può fornire un tipo di animale e un numero di pagina come parametri della stringa di query. Questi parametri di input devono essere mappati nei parametri della stringa di query dell'integrazione per inoltrare i valori di input al nostro PetStore sito Web nel backend. **Per mappare i parametri di input alla richiesta di integrazione** 1. Nella scheda **Richiesta di integrazione** scegli **Modifica** in **Impostazioni della richiesta di integrazione**. 1. Scegli **Parametri della stringa di query URL** ed effettua le seguenti operazioni: 1. Scegli **Aggiungi parametro della stringa di query**. 1. In **Nome**, inserisci **type**. 1. Per **Mappato da** immetti **method.request.querystring.type**. 1. Mantieni disattivata l'opzione **Caching**. 1. Scegli **Aggiungi parametro della stringa di query**. 1. In **Nome**, inserisci **page**. 1. Per **Mappato da** immetti **method.request.querystring.page**. 1. Mantieni disattivata l'opzione **Caching**. 1. Scegli **Save** (Salva). **Per testare l'API** 1. Seleziona la scheda **Test**. Potrebbe essere necessario scegliere il pulsante freccia destra per visualizzare la scheda. 1. In **Stringhe di query** immetti **type=Dog&page=2**. 1. Scegli **Test (Esegui test)**. Il risultato è simile al seguente: ![\[Risultato del metodo GET on Pets per la chiamata di test\]](http://docs.aws.amazon.com/it_it/apigateway/latest/developerguide/images/api-gateway-create-api-step-by-step-test-invoke-get-on-pets-result-new-console.png) Ora che il test è andato a buon fine, puoi distribuire l'API per renderla pubblicamente disponibile. 1. Seleziona **Deploy API (Distribuisci API)**. 1. In **Fase**, seleziona **Nuova fase**. 1. In **Stage name (Nome fase)** immettere **Prod**. 1. (Facoltativo) In **Descrizione**, immetti una descrizione. 1. Seleziona **Implementa**. 1. (Facoltativo) In **Dettagli fase** puoi scegliere l'icona Copia per copiare l'URL di richiamata dell'API in **Richiama URL**. È possibile usare questo valore con strumenti come [Postman](https://www.postman.com) e [cURL](https://curl.se/) per testare l'API. Se utilizzi un SDK per creare un client, puoi chiamare i metodi esposti dall'SDK per firmare la richiesta. Per maggiori dettagli sull'implementazione, consulta il kit [SDK AWS](https://aws.amazon.com/developer/tools/) scelto. **Nota** Se apporti modifiche alla tua API, devi ridistribuirla per fare in modo che le caratteristiche nuove o aggiornate siano disponibili prima di chiamare di nuovo l'URL di richiesta. ## (Facoltativo) Mappatura dei parametri di richiesta ### Mappatura di parametri di richieste per un'API di API Gateway Questo tutorial illustra come creare il parametro di percorso `{petId}` nella richiesta del metodo dell'API in modo da specificare un ID elemento, mapparlo al parametro di percorso `{id}` nell'URL della richiesta di integrazione e inviare la richiesta all'endpoint HTTP. **Nota** Se immetti una lettera maiuscola o minuscola errata, ad esempio una lettera minuscola anziché maiuscola, verranno restituiti errori più avanti nella procedura dettagliata. #### Fase 1: Creazione delle risorse In questa fase crei una risorsa con un parametro di percorso \$1petId\$1. **Per creare la risorsa \$1petId\$1** 1. Seleziona la risorsa **/pets**, quindi scegli **Crea risorsa**. 1. Mantieni l'opzione **Risorsa proxy** disattivata. 1. Per **Percorso risorsa** seleziona **/pets**. 1. Per **Resource Name (Nome risorsa)** immetti **\$1petId\$1**. Utilizza le parentesi graffe (`{ }`) per racchiudere `petId`, in modo da visualizzare **/pets/\$1petId\$1**. 1. Mantieni **CORS (Cross Origin Resource Sharing)** disattivato. 1. Scegli **Crea risorsa**. #### Fase 2: Creazione e test dei metodi In questa fase crei un metodo `GET` con un parametro di percorso `{petId}`. **Per configurare il metodo GET** 1. Seleziona la risorsa **/\$1petId\$1**, quindi scegli **Crea metodo**. 1. Per **Tipo di metodo** seleziona **GET**. 1. Per **Tipo di integrazione** seleziona **Integrazione HTTP**. 1. Mantieni l'opzione **Integrazione proxy HTTP** disattivata. 1. Per **Metodo HTTP** seleziona **GET**. 1. Per **URL dell'endpoint** immetti **http://petstore-demo-endpoint.execute-api.com/petstore/pets/\$1id\$1**. 1. Per **Gestione contenuti** seleziona **Transito**. 1. Mantieni attivata l'opzione **Timeout predefinito**. 1. Scegli **Crea metodo**. A questo punto mappare il parametro di percorso `{petId}` appena creato al parametro di percorso `{id}` nell'URL dell'endpoint HTTP della richiesta di integrazione. L'URL dell'endpoint HTTP è **http://petstore-demo-endpoint.execute-api.com/petstore/pets/\$1id\$1**. **Per mappare il parametro di percorso `{petId}`** 1. Nella scheda **Richiesta di integrazione** scegli **Modifica** in **Impostazioni della richiesta di integrazione**. 1. Scegli **Parametri di percorso URL**. 1. Gateway API crea un parametro di percorso per la richiesta di integrazione denominato **petId** che tuttavia non è valido per l'URL dell'endpoint HTTP impostato come integrazione backend. L'endpoint HTTP utilizza `{id}` come parametro di percorso. Per **Nome**, elimina **petId** e inserisci **id**. In questo modo, verrà mappato il parametro di percorso `petId` della richiesta del metodo al parametro di percorso `id` della richiesta di integrazione. 1. Scegli **Save** (Salva). Quindi testa il metodo. **Test del metodo ** 1. Seleziona la scheda **Test**. Potrebbe essere necessario scegliere il pulsante freccia destra per visualizzare la scheda. 1. In **Percorso** immetti **4** per **petId**. 1. Scegli **Test (Esegui test)**. Se il test ha esito positivo, in **Corpo della risposta** viene visualizzato quanto segue: ``` { "id": 4, "type": "bird", "price": 999.99 } ``` #### Fase 3: Distribuzione dell'API In questa fase, viene distribuita l'API per poter iniziare a richiamarla esternamente alla console API Gateway. **Per distribuire l'API** 1. Seleziona **Deploy API (Distribuisci API)**. 1. Per **Fase** seleziona **Produzione**. 1. (Facoltativo) In **Descrizione**, immetti una descrizione. 1. Selezionare **Deploy (Distribuisci)**. #### Fase 4: Test dell'API In questa fase verrà chiusa la console API Gateway e utilizzata l'API per accedere all'endpoint HTTP. 1. Nel pannello di navigazione principale scegli **Fase**. 1. In **Dettagli fase**, scegli l'icona Copia per copiare l'URL di richiamo dell'API. Dovrebbe essere simile a quanto segue: ``` https://my-api-id.execute-api.region-id.amazonaws.com/prod ``` 1. Inserisci questo URL nella casella dell'indirizzo di una nuova scheda del browser e aggiungi `/pets/4` all'URL prima di inviare la richiesta. 1. Il browser restituirà quanto segue: ``` { "id": 4, "type": "bird", "price": 999.99 } ``` #### Fasi successive Puoi personalizzare ulteriormente la tua API attivando la convalida delle richieste, trasformando i dati o creando risposte del gateway personalizzate. Per scoprire altri modi per personalizzare l'API, consulta i seguenti tutorial: + Per ulteriori informazioni sulla convalida della richiesta, consulta [Configurazione della convalida di base delle richieste in API Gateway](api-gateway-request-validation-set-up.md). + Per informazioni su come trasformare i payload di richiesta e risposta, consulta [Tutorial: modifica la richiesta e la risposta di integrazione per le integrazioni ai servizi AWS](set-up-data-transformations-in-api-gateway.md). + Per informazioni su come creare risposte del gateway personalizzate, consulta [Impostare una risposta del gateway per un'API REST utilizzando la console API Gateway](set-up-gateway-response-using-the-console.md).