Passaggio 6: pubblicazione di un'API

UI di Cloud Console

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

   Vai ai proxy API

2. Fai clic su Crea. Si apre 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 specifica OpenAPI, proxy inverso (il più comune).

5. Apri il seguente file in un browser, quindi salvalo:

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

6. Nel passaggio 1: specifiche OpenAPI, fai clic su Sfoglia.

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

8. Fai clic su Avanti.

9. In Passaggio 2: dettagli proxy, i campi vengono precompilati utilizzando i valori della specifica OpenAPI. Modifica il campo Descrizione nel seguente modo: Proxy API per Hello World.

10. Fai clic su Avanti.

11. In Passaggio 3 Flussi, seleziona tutte le operazioni.

12. Fai clic su Avanti.

13. Nel 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 sottoposto a deployment, la colonna Stato nella sezione Deployment mostra un'icona verde per indicare che la revisione del proxy API è stata sottoposta a deployment. Puoi tenere il puntatore sopra l'icona di stato per visualizzare ulteriori informazioni sull'implementazione.

UI classica

1. Nell'interfaccia utente Apigee, seleziona Sviluppa > Proxy API nella barra di navigazione a sinistra per aprire la pagina dei proxy API.

2. Fai clic su Crea nuovo.

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

3. In Reverse Proxy (il più comune), fai clic su Usa specifica OpenAPI.

   Viene visualizzata la finestra di dialogo Usa specifica OpenAPI.

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

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

5. Fai clic su Seleziona. Si apre la procedura guidata Crea proxy e la pagina Dettagli proxy viene precompilata utilizzando i valori della specifica OpenAPI.

   

6. Modifica il campo Descrizione nel seguente modo: Proxy API per Hello World.

7. Fai clic su Avanti.

8. Nella pagina Policy:

   • Nella sezione Sicurezza: autorizzazione, seleziona Pass through (no authorization).
   • In Sicurezza: browser, seleziona Aggiungi intestazioni CORS .

   

9. Fai clic su Avanti.

10. Nella pagina Flussi, assicurati che tutte le operazioni siano selezionate e fai clic su Avanti.

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 una conferma che il nuovo proxy API è stato creato correttamente e il deployment è stato eseguito nell'ambiente selezionato.

UI 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 aprire il portale.

3. Fai clic sulla scheda API.

4. Fai clic su + API.

5. Per Prodotto API, seleziona Hello World.

6. Seleziona Pubblicato (elencato nel catalogo) per pubblicare l'API nel portale.

7. In Titolo visualizzato, inserisci Hello World.

8. Per Immagine visualizzata, 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 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.

UI classica

1. Nell'interfaccia utente Apigee, vai alla pagina API del portale:
   1. Seleziona Pubblica > Portali nella barra di navigazione a sinistra.
   2. Fai clic sulla riga Il mio primo portale per aprire il portale.
   3. Fai clic su Catalogo API per visualizzare la pagina delle 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. Nella sezione Dettagli API, configura le seguenti opzioni:
   • Seleziona Pubblicato (elencato nel catalogo) per pubblicare l'API nel portale.
   • Per l'immagine di copertina:
     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.
   • Per Categorie, inserisci Inizia e premi Invio.

   Lascia invariati tutti gli altri valori predefiniti.

   

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 specifica.
   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.

   

6. Fai clic su Salva.