Passaggio 6: pubblicazione di un'API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

In questo passaggio, pubblicherai un'API nel portale seguendo questi passaggi:

  1. Creare un proxy API da una specifica
  2. Crea un prodotto API
  3. Pubblica l'API nel tuo portale

Passaggio 1: crea un proxy API da una specifica

Crea un proxy API da una specifica OpenAPI che descrive l'API.

Per creare un proxy API da una specifica OpenAPI:

Interfaccia utente di Cloud Console

  1. Nella console Apigee in Cloud, vai alla pagina Sviluppo proxy > Proxy API.

    Vai ai proxy API

  2. Fai clic su Crea. Viene visualizzata la procedura guidata Crea un proxy, che ti chiede di selezionare il tipo di proxy API da creare.

  3. Fai clic nella casella Modello proxy.

  4. Fai clic su Modello di specifiche OpenAPI, proxy inverso (il più comune).

  5. Apri il seguente file in un browser e salvalo:

    https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml

  6. In Passaggio 1 Specifiche OpenAPI, fai clic su Sfoglia.

  7. Vai a un file di specifiche OpenAPI che hai appena scaricato, selezionalo e fai clic su Apri.

  8. Fai clic su Avanti.

  9. In Passaggio 2 Dettagli del proxy, i campi vengono precompilati utilizzando i valori della specifica OpenAPI. Modifica il campo Descrizione come segue: Proxy API per Hello World.

  10. Fai clic su Avanti.

  11. In Flui di passaggio 3, seleziona tutte le operazioni.

  12. Fai clic su Avanti.

  13. In Passaggio 4 Esegui il deployment, seleziona l'ambiente in cui vuoi eseguire il deployment.

  14. Fai clic su OK.

  15. Fai clic su Crea.

Quando il proxy viene disegnato, la colonna Stato nella sezione Deployment visualizza un'icona verde per indicare che la revisione del proxy API è stata disegnato. Puoi tenere premuto il cursore sopra l'icona di stato per visualizzare ulteriori informazioni sul deployment.

Interfaccia utente classica

  1. Nell'interfaccia utente di Apigee, seleziona Sviluppa > Proxy API nella barra di navigazione a sinistra per aprire la pagina Proxy API.
  2. Fai clic su Crea nuova. Aggiungi proxy API

    Viene visualizzata la procedura guidata Crea proxy che ti chiede di selezionare il tipo di proxy API da creare.

  3. In Proxy inverso (il più comune), fai clic su Utilizza la specifica OpenAPI. Utilizzare la specifica OpenAPI

    Viene visualizzata la finestra di dialogo Utilizza la specifica OpenAPI.

  4. Copia e incolla il seguente URL nel campo URL specifica OpenAPI della scheda URL:

    https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml
  5. Fai clic su Seleziona. Viene visualizzata la procedura guidata Crea proxy e la pagina Dettagli proxy viene precompilata utilizzando i valori della specifica OpenAPI.

    Pagina dei dettagli del proxy nella procedura guidata Crea proxy, precompilata con i contenuti

  6. Modifica il campo Descrizione come segue: Proxy API per Hello World.

  7. Fai clic su Avanti.

  8. Nella pagina Norme:

    • In Sicurezza: autorizzazione, seleziona Passa (nessuna autorizzazione).
    • In Sicurezza: browser, seleziona Aggiungi intestazioni CORS .

    Pagina Norme comuni nella procedura guidata Crea proxy con le opzioni Trasferisci e Aggiungi intestazioni CORS selezionate

  9. Fai clic su Avanti.

  10. Nella pagina Fluidi, assicurati che tutte le operazioni siano selezionate e fai clic su Avanti. Creare flussi proxy

  11. Nella pagina Riepilogo, seleziona l'ambiente in cui vuoi eseguire il deployment in Deployment facoltativo.

  12. Fai clic su Crea ed esegui il deployment.

Nella pagina Riepilogo, vedrai un messaggio di conferma che indica che il nuovo proxy API è stato creato correttamente e disegnato nell'ambiente selezionato.

Passaggio 2: crea un prodotto API

Crea un prodotto API contenente le risorse API che vuoi esporre ai tuoi consumatori di API.

Per creare un prodotto API:

  1. Nella console Apigee in Cloud, vai alla pagina Distribuzione > Prodotti API.

    Vai ai prodotti API

  2. Fai clic su Crea. Viene visualizzata la pagina Dettagli prodotto. Inserisci i dettagli del prodotto per il prodotto API.

    Campo Valore
    Nome Hello World
    Nome visualizzato Hello World
    Descrizione Esempio semplice di ciao mondo
    Ambiente Seleziona l'ambiente in cui è stato eseguito il deployment del proxy API.
    Accesso Pubblica
    Approvare automaticamente le richieste di accesso Abilitata
    Quota (Lasciare vuoto)
    Ambiti OAuth consentiti (Lasciare vuoto)

  3. Nella sezione Operazioni, fai clic su Aggiungi un'operazione per identificare le operazioni da aggiungere al prodotto API.

    • In Origine, seleziona Proxy API e poi Mock-Target-API dal menu a discesa.
    • In Operazione, inserisci una barra (/) nel campo Percorso. Ignora gli altri campi.
  4. Fai clic su Salva per salvare l'operazione.

  5. Fai clic su Salva per salvare il prodotto.

Passaggio 3: pubblica l'API nel tuo portale

Pubblica l'API nel tuo portale per consentire ai clienti di conoscerla e utilizzarla.

Per pubblicare l'API nel tuo portale:

Interfaccia utente di Cloud Console

  1. Nella console Apigee in Cloud, vai alla pagina Distribuzione > Portali.

    Vai a Portali

  2. Fai clic sulla riga Il mio primo portale per aprirlo.

  3. Fai clic sulla scheda API.

  4. Fai clic su + API.

  5. Per Prodotto API, seleziona Hello World.

  6. Seleziona Pubblicata (elencata nel catalogo) per pubblicare l'API nel tuo portale.

  7. In Titolo visualizzato, inserisci Hello World.

  8. In Mostra immagine, fai clic su Seleziona.

  9. Fai clic su Asset.

  10. Fai clic su Anteprima per home-background.jpg.

  11. Fai clic su Seleziona.

  12. Per la documentazione dell'API, per generare automaticamente la documentazione di riferimento dell'API da uno snapshot della specifica OpenAPI:

    1. Seleziona Documento OpenAPI.
    2. Fai clic su Seleziona.
    3. Fai clic sulla scheda URL.
    4. Digita helloworld nel campo Nome della specifica.
    5. Copia e incolla il seguente URL nel campo URL:
      https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml
    6. Fai clic su Seleziona.
  13. Fai clic su Salva.

Interfaccia utente classica

  1. Nell'interfaccia utente di Apigee, vai alla pagina API nel tuo portale:
    1. Seleziona Pubblica > Portali nella barra di navigazione a sinistra.
    2. Fai clic sulla riga Il mio primo portale per aprirlo.
    3. Fai clic su Catalogo API per visualizzare la pagina API.
  2. Fai clic su +.
  3. Seleziona Hello World nella finestra di dialogo Aggiungi un prodotto API al catalogo e fai clic su Avanti.
  4. In Dettagli API, configura le seguenti opzioni:
    • Seleziona Pubblicata (elencata nel catalogo) per pubblicare l'API nel tuo portale.
    • Per Immagine di visualizzazione:
      1. Fai clic su Seleziona immagine.
      2. Fai clic su home-background.jpg nell'elenco delle immagini esistenti nella finestra di dialogo Seleziona immagine.
      3. Fai clic su Seleziona.
      4. Visualizza l'anteprima dell'immagine e fai clic su Seleziona.
    • In Categorie, inserisci Inizia e premi Invio.

    Lascia gli altri valori impostati sui valori predefiniti.

    Sezione dei dettagli dell'API quando aggiungi un'API al portale

  5. In Documentazione API, per generare automaticamente la documentazione di riferimento dell'API da uno snapshot della specifica OpenAPI:
    1. Seleziona Documento OpenAPI.
    2. Fai clic su Seleziona documento.
    3. Seleziona la scheda Importa da un URL.
    4. Inserisci helloworld nel campo Nome spec.
    5. Copia e incolla il seguente URL nel campo URL e premi Invio:
      https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget3.0.yaml
    6. Fai clic su Seleziona.

    Sezione della documentazione dell'API quando aggiungi un'API al portale

  6. Fai clic su Salva.

Passaggio 4: visualizza la documentazione di riferimento dell'API

Per visualizzare la documentazione di riferimento dell'API:

  1. Nell'interfaccia utente di Apigee, fai clic su Portale in produzione per visualizzare le modifiche nel portale in produzione (o aggiorna il portale in produzione se è già aperto in un'altra scheda).
  2. Nel portale live:
    1. Fai clic su API nella barra di navigazione in alto per visualizzare l'API pubblicata.
    2. Fai clic sulla scheda Hello World per visualizzare la documentazione di riferimento dell'API.
    3. Prova la tua API.

API target simulata pubblicata con il riquadro Prova questa API