Gestisci le specifiche

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Apigee Edge ti offre uno spazio per archiviare le tue specifiche OpenAPI. Gestisci le tue specifiche OpenAPI, come descritto nelle sezioni seguenti.

Per ulteriori informazioni sulle specifiche OpenAPI, consulta Che cos'è una specifica OpenAPI?

Esplora l'elenco delle specifiche

Per accedere all'elenco delle specifiche:

1. Accedi ad apigee.com/edge.
2. Seleziona un'organizzazione.
3. Seleziona Sviluppo > Specifiche nel menu di navigazione laterale.

Viene visualizzato l'elenco attuale di specifiche e cartelle.

Come evidenziato nella figura precedente, dall'elenco delle specifiche puoi:

• Specifiche per la creazione e l'import
• Genera un proxy API da una specifica utilizzando una procedura guidata in più passaggi
• Organizza le tue specifiche utilizzando le cartelle e sfoglia le cartelle (vedi Organizzazione dei contenuti utilizzando le cartelle).
• Modificare una specifica o aprire una cartella facendo clic su una riga
• Rinominare o eliminare una specifica
• Cerca nell'elenco di specifiche e cartelle

Crea una nuova specifica OpenAPI

Per creare una nuova specifica OpenAPI:

1. Fai clic su Sviluppo > Specifiche nella barra di navigazione laterale.
2. Fai clic su + Specifiche.
3. Fai clic su Nuova specifica nel menu a discesa. Si apre l'editor delle specifiche.
4. Sostituisci la specifica di esempio con i dettagli della specifica OpenAPI.
   Vedi Creare le specifiche utilizzando l'editor delle specifiche.
5. Fai clic su Salva per salvare la specifica.
6. Inserisci un nome per la specifica quando richiesto.
7. Fai clic su Salva.

Importa una specifica OpenAPI

Per importare una specifica OpenAPI:

1. Fai clic su Sviluppo > Specifiche nella barra di navigazione laterale.
2. Fai clic su + Specifiche.
3. Fai clic su una delle seguenti opzioni nel menu a discesa:
   • Importa URL per importare la specifica da un URL. Specifica il nome e l'URL quando richiesto.
   • Importa file per cercare la specifica nella directory locale.
     La specifica viene aggiunta all'elenco.
4. Fai clic sul nome della specifica per visualizzarla e modificarla nell'editor delle specifiche.
   Consulta la sezione Creare specifiche utilizzando l'editor delle specifiche.

Modifica una specifica OpenAPI esistente

Per aprire una specifica OpenAPI esistente:

1. Fai clic su Sviluppo > Specifiche nella barra di navigazione laterale.
2. Fai clic sulla riga associata alla specifica nell'elenco delle specifiche.
3. Modifica la specifica nell'editor delle specifiche.
   Vedi Creare le specifiche utilizzando l'editor delle specifiche.

Crea un proxy API da una specifica nell'elenco delle specifiche

Con Apigee Edge, puoi creare i tuoi proxy API dalle specifiche OpenAPI che progetti e salvi nell'editor delle specifiche. In pochi clic sarà disponibile un proxy API in Apigee Edge con percorsi, parametri, flussi condizionali ed endpoint di destinazione generati automaticamente. Successivamente, puoi aggiungere funzionalità quali la sicurezza OAuth, la limitazione della frequenza e la memorizzazione nella cache.

Dopo aver creato un proxy API da una specifica OpenAPI, se la specifica viene modificata, dovrai modificare manualmente il proxy API per riflettere le modifiche implementate. Consulta la sezione Che cosa succede se modifico una specifica?.

Per creare un proxy API da una specifica OpenAPI nell'elenco delle specifiche:

1. Seleziona Sviluppo > Specifiche nel menu di navigazione laterale.
2. Vai alla cartella che contiene la specifica OpenAPI, se necessario.
3. Posiziona il cursore sulla specifica OpenAPI per la quale vuoi creare un proxy API per visualizzare il menu delle azioni.
4. Fai clic su . Viene aperta la procedura guidata Crea proxy e la pagina Dettagli proxy viene precompilata utilizzando i valori della specifica OpenAPI, come illustrato nella figura seguente.
   
5. Fai clic su Avanti.
6. Esamina le pagine rimanenti della procedura guidata Crea proxy, come descritto in Creazione di un proxy API da una specifica OpenAPI. (Inizia dal passaggio 8).

Rinominare una specifica

Per rinominare una specifica:

1. Seleziona Sviluppo > Specifiche nel menu di navigazione laterale.
2. Vai alla cartella che contiene la specifica, se necessario.
3. Posiziona il cursore sulla specifica che vuoi rinominare per visualizzare il menu delle azioni.
4. Fai clic su .
5. Modifica il nome della specifica.
6. Fai clic su Rinomina per salvare le modifiche o su Annulla per annullarle.

Spostare una specifica in una cartella

Puoi organizzare le specifiche in cartelle per semplificare la gestione e la sicurezza. Per spostare una specifica in una cartella, vedi Organizzazione delle specifiche utilizzando le cartelle.

Elimina una specifica

Puoi eliminare una specifica dall'archivio file quando non è più necessaria o non è più valida.

Per eliminare una specifica:

1. Seleziona Sviluppo > Specifiche nel menu di navigazione laterale.
2. Posiziona il cursore sulla specifica che vuoi eliminare per visualizzare il menu delle azioni.
3. Fai clic su .
4. Fai clic su Elimina per confermare l'operazione di eliminazione quando ti viene richiesto.
5. Elimina gli artefatti correlati che non sono più necessari.