Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 4: testa l'API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Per testare l'API helloworld di cui è stato eseguito il deployment, fai clic sulla scheda Terminale in Apigee in Cloud Code e inserisci la seguente chiamata curl:

curl 0:8998/helloworld

Viene visualizzato il seguente messaggio di errore:

Chiamate API nella scheda del terminale e ricezione di un errore di autorizzazione

Poiché hai attivato l'autenticazione basata su chiave API durante la creazione del proxy API, devi passare una chiave API utilizzando il parametro di query apikey quando chiami l'API.

Per ottenere una chiave API, devi creare un bundle di test e configurare le seguenti risorse di test:

Prodotto API utilizzato per raggruppare l'API e renderla disponibile agli sviluppatori.
Sviluppatore che creerà un'app per accedere all'API.
App per sviluppatori che consente l'accesso all'API utilizzando una chiave API.

Nota: gli esempi in questa sezione utilizzano 0 per il valore dell'host e 8998 per il valore della porta. Puoi configurare i valori della porta, come descritto in Gestione dell'emulatore Apigee. Se ricevi un errore quando utilizzi 0, sostituisci localhost con localhost:0

curl localhost:8998/helloworld

Crea ed esporta le risorse di test

Crea un pacchetto di test:
1. Posiziona il cursore del mouse sulla cartella tests e fai clic su .
  
  Viene visualizzata la procedura guidata Crea bundle di test.
2. Inserisci mytestbundle come nome del pacchetto di test e premi Invio.
  Il pacchetto di test viene creato.
3. Espandi la cartella mytestbundle per visualizzarne i contenuti.
Configura la risorsa di test del prodotto API:
1. Posiziona il cursore sul file products.json e fai clic su .
  
  Viene visualizzata la procedura guidata Crea prodotto API.
2. Inserisci myproduct per il nome del prodotto API e premi Invio per confermare e procedere.
3. Inserisci myproduct per la descrizione del prodotto dell'API e premi Invio per confermare e procedere.
4. Seleziona helloworld per aggiungere il proxy API al prodotto API e fai clic su OK.
  Il file products.json si apre nell'editor con il nuovo prodotto API configurato:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "scopes": [],
    "environments": [],
    "apiResources": [
      "/",
      "/*",
      "/**"
    ],
    "quota": "100",
    "quotaInterval": "1",
    "quotaTimeUnit": "minute",
    "name": "myproduct",
    "displayName": "myproduct",
    "proxies": [
      "helloworld"
    ]
  }
]
```
Configura la risorsa di test dello sviluppatore:
1. Posiziona il cursore sul file developers.json e fai clic su .
  
  Si apre la procedura guidata Crea sviluppatore.
2. Inserisci i seguenti valori quando richiesto e premi Invio per confermare e procedere:
  - Indirizzo email dello sviluppatore: ahamilton@example.com
  - Nome utente: ahamilton
  - Nome: Alex
  - Cognome: Hamilton
  Il file developers.json si apre nell'editor con il nuovo sviluppatore configurato:
```
[
    {
      "attributes": [
        {
          "name": "sample_attribute_0",
          "value": "sample_attribute_value_0"
        }
      ],
      "email": "ahamilton@example.com",
      "userName": "ahamilton",
      "firstName": "Alex",
      "lastName": "Hamilton"
    }
  ]
```
Configura la risorsa di test dell'app per sviluppatori:
1. Posiziona il cursore sul file developerapps.json e fai clic su .
  
  Viene visualizzata la procedura guidata Crea app per sviluppatori.
2. Seleziona ahamilton@example.com come proprietario dell'app.
3. Inserisci i seguenti valori nella serie di prompt successiva e premi Invio per confermare e procedere:
  - Nome dell'app: myapp
  - Descrizione: myapp
  - URL di callback: Lascia vuoto
  - Seleziona myproduct per aggiungerlo all'app e fai clic su OK.
  - Seleziona Mai per il valore di scadenza.
  Il file developerapps.json si apre nell'editor con la nuova app configurata:
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "developerEmail": "ahamilton@example.com",
    "name": "myapp",
    "displayName": "myapp",
    "callbackUrl": "",
    "apiProducts": [
      "myproduct"
    ],
    "expiryType": "never"
  }
]
```
Esporta le risorse di test nell'emulatore Apigee.
Posiziona il cursore sul bundle di test mytestbundle e fai clic su .

Nota: se sono in esecuzione più container per l'emulatore Apigee, ti viene chiesto di selezionare il contenitore in cui vuoi eseguire il deployment dell'ambiente.

Le risorse di test attive vengono visualizzate nella sezione Emulatori Apigee, come mostrato nella figura seguente.

Ottenere la chiave API

Ottieni le credenziali della chiave API per la tua app per sviluppatori:

Nella sezione emulatori, fai clic su App per sviluppatori attive in Dati di test attivi.
Il file di configurazione delle app per sviluppatori attive viene aperto nell'editor. Il file contiene le credenziali per myproduct, come evidenziato nella figura seguente.
```
<p><img src="/apigee/docs/api-platform/images/vscode-consumerkey.png" alt="Developer apps with the consumerKey value highlighted."></p>
```
Copia il valore consumerKey (senza virgolette) per il prodotto API myproduct.

Testare l'API

Testa l'API con la chiave API:

Passa la chiave API nella chiamata curl utilizzando il parametro di query apikey, come segue:
```
curl 0:8998/helloworld?apikey=API_KEY
```
Viene restituita la seguente risposta:
```
Hello, Guest!
```

Complimenti! Hai eseguito correttamente un'API nel tuo ambiente locale.

Nel passaggio successivo, scoprirai come modificare l'endpoint di destinazione.

1 2 3 4 (AVANTI) Passaggio 5: modifica l'endpoint di destinazione 6 7 8