Creazione ed esportazione delle risorse di test

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Prima di testare le API, potresti dover creare un insieme di risorse di test, come prodotti API, sviluppatori o app, che rappresentano le stesse risorse che potrebbero esistere nell'ambiente di produzione della tua organizzazione Apigee.

Crea ed esporta le risorse di test come descritto nelle sezioni seguenti. Consulta anche Gestire cartelle e file in uno spazio di lavoro Apigee.

Creazione delle risorse di test

Per creare le risorse di test, crea un bundle di test e modifica le risorse di test definite nella tabella seguente.

Risorsa di test Descrizione
Prodotti API (products.json) Definisci i prodotti API utilizzati per raggruppare le API e mettili a disposizione degli sviluppatori.
Sviluppatori (developers.json) Registra gli sviluppatori che accederanno alle tue API.
App per sviluppatori (developerapps.json) Registra le app per controllare l'accesso alle tue API.
Mappe chiave-valore (maps.json) Definisci le mappe chiave/valore utilizzate dalle tue API per archiviare i dati per il recupero in fase di esecuzione.

Creazione di un bundle di test

Per creare un bundle di test in Cloud Code:

  1. Esegui una delle seguenti azioni:

    • Posiziona il cursore sulla cartella dei dati di test nella tua area di lavoro Apigee e fai clic su Icona Crea pacchetto di test. Il segno + viene visualizzato quando posizioni il cursore sulla cartella dei test

    • Seleziona Visualizza > Riquadro dei comandi per aprire la tavolozza dei comandi e seleziona Cloud Code: crea bundle di test Apigee.

  2. Inserisci un nome univoco per il pacchetto di test e premi Invio.

Il bundle di test viene aggiunto alla cartella Dati di test nella sezione Apigee.

Cartella di test con i file developerapps.json, developers.json, maps.json e products.json

Configura le risorse di test, come descritto nelle sezioni seguenti.

Definizione dei prodotti API (products.json)

Definisci i prodotti API utilizzati per raggruppare le API e mettili a disposizione degli sviluppatori. Per ulteriori informazioni sui prodotti API, consulta Che cos'è un prodotto API?

Per definire i prodotti API, aggiorna il file products.json utilizzando la configurazione guidata o modificando direttamente il file di configurazione products.json. Per una descrizione dei campi nel file products.json, consulta Risorsa: ApiProduct.

Per definire i prodotti API utilizzando la configurazione guidata:

  1. Posiziona il cursore sul file products.json per il bundle di test e fai clic su Icona della procedura guidata per definire un prodotto API. Viene visualizzata la procedura guidata Crea prodotto API.

    Prima pagina della procedura guidata Crea prodotto API

  2. Inserisci un nome per il prodotto API e segui la procedura guidata di configurazione per compilare automaticamente i campi nel file products.json. Il file products.json si apre nell'editor.

  3. Modifica le informazioni di configurazione, se necessario.

  4. Seleziona File > Salva o ⌘S per salvare le modifiche.

L'esempio seguente definisce il prodotto API myapiproduct che contiene il proxy API helloworld.

[
  {
    "apiResources": [
      "/",
      "/*",
      "/**"
    ],
    "quota": "100",
    "quotaInterval": "1",
    "quotaTimeUnit": "minute",
    "name": "myapiproduct",
    "displayName": "My first API product",
    "proxies": [
      "helloworld"
    ]
  }
]

Registrazione degli sviluppatori (developers.json)

Registra gli sviluppatori che accederanno alle tue API. Per ulteriori informazioni sugli sviluppatori, consulta la sezione Registrazione degli sviluppatori di app.

Per registrare gli sviluppatori, aggiorna il file developers.json utilizzando la configurazione guidata o modificando direttamente il file di configurazione developers.json. Per una descrizione dei campi nel file developers.json, consulta Risorsa: sviluppatore.

Per registrare gli sviluppatori utilizzando la configurazione guidata:

  1. Posiziona il cursore sul file developers.json per il bundle di test e fai clic su Icona della procedura guidata Cloud Code per registrare gli sviluppatori.
  2. Inserisci l'indirizzo email dello sviluppatore e altri valori nella procedura guidata di configurazione per compilare automaticamente i campi nel file developers.json. Il file developers.json si apre nell'editor.
  3. Modifica la configurazione, se necessario.
  4. Seleziona File > Salva o ⌘S per salvare le modifiche.

L'esempio seguente definisce lo sviluppatore ahamilton@example.com:

[
  {
    "email": "ahamilton@example.com",
    "userName": "ahamilton",
    "firstName": "Alex",
    "lastName": "Hamilton"
  }
]

Registrazione delle app sviluppatore (developerapps.json)

Registra le app per sviluppatori per controllare l'accesso alle tue API. Per saperne di più sulla registrazione delle app per sviluppatori, consulta Controllare l'accesso alle API mediante la registrazione delle app.

Per registrare le app per sviluppatori, aggiorna il file developerapps.json utilizzando la configurazione guidata o modificando direttamente il file di configurazione developerapps.json. Per una descrizione dei campi nel file developerapps.json, consulta Risorsa: DeveloperApp.

Per registrare le app per sviluppatori utilizzando la configurazione guidata:

  1. Posiziona il cursore sul file developerapps.json per il bundle di test e fai clic su Icona della procedura guidata per registrare le app per sviluppatori.

  2. Seleziona lo sviluppatore e altri valori per compilare automaticamente i campi nel file developerapps.json. Il file developerapps.json si apre nell'editor.

  3. Modifica la configurazione, se necessario.

  4. Seleziona File > Salva o ⌘S per salvare le modifiche.

Nell'esempio seguente viene registrata l'app per sviluppatori myapp per ahamilton@example.com e viene associato myproduct:

[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "developerEmail": "ahamilton@example.com",
    "name": "myapp",
    "callbackUrl": "",
    "keyExpiresIn": "",
    "apiProducts": [
      "myproduct"
    ]
  }
]

Definizione delle mappe chiave-valore (maps.json)

Definisci le mappe chiave/valore (KVM) utilizzate dalle tue API per archiviare i dati per il recupero in fase di esecuzione. Per ulteriori informazioni sulle mappe chiave-valore, consulta Utilizzare le mappe chiave-valore.

Per definire le mappe di valori chiave, aggiorna il file maps.json utilizzando la configurazione guidata o modificando direttamente il file di configurazione maps.json. Per una descrizione dei campi nel file maps.json, consulta la risorsa KeyValueMap.

Per definire le KVM utilizzando la configurazione guidata:

  1. Posiziona il cursore sul file maps.json per il bundle di test e fai clic su Icona della procedura guidata per definire le mappe chiave-valore.
  2. Seleziona l'ambito e altri valori per compilare automaticamente i campi nel file maps.json. Il file maps.json si apre nell'editor.
  3. Modifica la configurazione, se necessario.
  4. Seleziona File > Salva o ⌘S per salvare le modifiche.

L'esempio seguente definisce la KVM criptata mykvm:

[
  {
    "name": "mykvm",
    "encrypted": true
  }
]

Esportazione delle risorse di test nell'emulatore Apigee

Per esportare le risorse di test nell'emulatore Apigee:

  1. Posiziona il cursore sul bundle di test da esportare e fai clic su Icona Esporta risorsa di test.

    L'icona di esportazione viene visualizzata quando posizioni il cursore sul nome del pacchetto di test

  2. Se sono in esecuzione più contenitori per l'emulatore Apigee, seleziona quello in cui vuoi eseguire il deployment dell'ambiente.

Le risorse di test attive vengono visualizzate in Apigee Emulator, come mostrato nella figura seguente.

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

Visualizza i contenuti della risorsa di test per ottenere informazioni specifiche sulle risorse, ad esempio una chiave API per i test che viene generata automaticamente e inclusa nella risorsa di test dell'app per sviluppatori.