Passaggio 4: testa l'API

Questa pagina si applica a Apigee e Apigee ibrido.

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:

Chiamata all'API nella scheda Terminale e visualizzazione 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 sviluppatore che consentirà di accedere all'API utilizzando una chiave API

Crea ed esporta risorse di test, ottieni la chiave API e ripeti il test dell'API.

  1. Crea un bundle di test:
    1. Posiziona il cursore sulla cartella tests nella sezione Apigee e fai clic su Icona Crea.

      Il simbolo + viene visualizzato quando posizioni il cursore sulla cartella dei test

      Si apre la procedura guidata Crea bundle di test.

    2. Inserisci mytestbundle come nome del bundle di test e premi Invio.

      Il bundle di test è stato creato.

    3. Espandi la cartella mytestbundle nella sezione Apigee per visualizzarne il contenuto.

      Testa la cartella con i file developerapps.json, developers.json, maps.json e products.json

  2. Configura la risorsa di test del prodotto API:
    1. Posiziona il cursore sul file products.json nella sezione Apigee e fai clic su Icona Crea.

      + viene visualizzato quando posizioni il cursore su products.json

      Si apre la procedura guidata Create API (Crea prodotto API).

      Prima pagina della procedura guidata del prodotto Create API

    2. Inserisci myproduct come nome del prodotto API e premi Invio per confermare e continuare.
    3. Inserisci myproduct come descrizione del prodotto API e premi Invio per confermare e continuare.
    4. Seleziona helloworld per aggiungere il proxy API al prodotto API e fai clic su OK.

      Il file products.json viene aperto nell'editor con il nuovo prodotto API configurato, come mostrato di seguito:

      [
        {
          "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"
          ]
        }
      ]
  3. Configura la risorsa di test dello sviluppatore:
    1. Posiziona il cursore sul file developers.json nella sezione Apigee e fai clic su Icona Crea.

      + viene visualizzato quando posizioni il cursore su developers.json

      Si apre la procedura guidata Crea sviluppatore.

      Prima pagina della procedura guidata del prodotto Create API

    2. Inserisci i seguenti valori in corrispondenza dei prompt e premi Invio per confermare e continuare:
      • Email dello sviluppatore: ahamilton@example.com
      • Nome utente: ahamilton
      • Nome: Alessandro
      • Cognome: Hamilton

      Il file developers.json viene aperto nell'editor con il nuovo sviluppatore configurato, come mostrato di seguito:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "email": "ahamilton@example.com",
          "userName": "ahamilton",
          "firstName": "Alex",
          "lastName": "Hamilton"
        }
      ]
  4. Configura la risorsa di test dell'app sviluppatore:
    1. Posiziona il cursore sul file developerapps.json nella sezione Apigee e fai clic su Icona Crea.

      + viene visualizzato quando posizioni il cursore su developerapps.json

      Si apre la procedura guidata Crea app sviluppatore.

      Prima pagina della procedura guidata del prodotto Create API

    2. Seleziona ahamilton@example.com come proprietario dell'app.
    3. Inserisci i seguenti valori nel set di prompt successivo e premi Invio per confermare e continuare:
      • Nome dell'app: myapp
      • Descrizione: myapp
      • URL di callback: lascia vuoto
    4. Seleziona myproduct per aggiungerlo all'app e fai clic su OK.
    5. Seleziona never (mai) come valore di scadenza.

      Il file developerapps.json viene aperto nell'editor con la nuova app configurata, come mostrato di seguito:

      [
        {
          "attributes": [
            {
              "name": "sample_attribute_0",
              "value": "sample_attribute_value_0"
            }
          ],
          "developerEmail": "ahamilton@example.com",
          "name": "myapp",
          "displayName": "myapp",
          "callbackUrl": "",
          "apiProducts": [
            "myproduct"
          ],
          "expiryType": "never"
        }
      ]
  5. Esporta le risorse di test nell'emulatore Apigee.

    Nella sezione Apigee, posiziona il cursore sul bundle di test mytestbundle e fai clic su Icona Esporta test.

    Risorse di test attive, tra cui prodotti API, sviluppatori e app per sviluppatori

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

    Risorse di test attive, tra cui prodotti API, sviluppatori e app per sviluppatori

  6. Nella sezione Emulatori Apigee, in Risorse di test attive, fai clic su App sviluppatore attive.

    Il file di configurazione delle app per sviluppatori attivi viene aperto nell'editor. Il file contiene le credenziali di myproduct, come evidenziato nella figura seguente.

    App sviluppatore con il valore consumerKey evidenziato.

  7. Copia il valore consumerKey (senza le virgolette) per il prodotto API myproduct.
  8. Passa la chiave API nella chiamata curl utilizzando il parametro di query apikey, come segue:
    curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    Viene restituita la seguente risposta:

    Hello, Guest!

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

Nel passaggio successivo imparerai a modificare l'endpoint di destinazione.

1 2 3 4 (AVANTI) Passaggio 5: modifica dell'endpoint di destinazione 1} 1}