Gestisci le specifiche

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Apigee Edge ti offre uno spazio in cui archiviare le specifiche OpenAPI. Gestisci le 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 a apigee.com/edge.
  2. Seleziona un'organizzazione.
  3. Seleziona Sviluppa > Specifiche nel menu di navigazione laterale.

Viene visualizzato l'elenco attuale di specifiche e cartelle.

Elenco delle specifiche

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

Crea una nuova specifica OpenAPI

Per creare una nuova specifica OpenAPI:

  1. Fai clic su Sviluppa > Specifiche nella barra di navigazione laterale.
  2. Fai clic su + Spec (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 tua specifica OpenAPI.
    Consulta Creare specifiche utilizzando l'editor delle specifiche.
  5. Fai clic su Salva per salvare la specifica.
  6. Quando richiesto, inserisci un nome per la specifica.
  7. Fai clic su Salva.

Importare una specifica OpenAPI

Per importare una specifica OpenAPI:

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

Modificare una specifica OpenAPI esistente

Per aprire una specifica OpenAPI esistente:

  1. Fai clic su Sviluppa > 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.
    Consulta Creare 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. Con pochi clic, avrai un proxy API in Apigee Edge con i percorsi, i parametri, i flussi condizionali e gli endpoint di destinazione generati automaticamente. Poi, puoi aggiungere funzionalità come la sicurezza OAuth, la limitazione di 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 Che cosa succede se modifico una specifica?.

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

  1. Seleziona Sviluppa > Specifiche nel menu di navigazione laterale.
  2. Se necessario, vai alla cartella contenente la specifica OpenAPI.
  3. Posiziona il cursore sulla specifica OpenAPI per cui vuoi creare un proxy API per visualizzare il menu delle azioni.
  4. Fai clic su genera proxy. Viene visualizzata la procedura guidata Crea proxy e la pagina dei dettagli del proxy viene precompilata utilizzando i valori della specifica OpenAPI, come mostrato nella figura seguente.
    creare una procedura guidata per i proxy
  5. Fai clic su Avanti.
  6. Segui i passaggi delle 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 Sviluppa > Specifiche nel menu di navigazione laterale.
  2. Se necessario, vai alla cartella contenente la specifica.
  3. Posiziona il cursore sulla specifica che vuoi rinominare per visualizzare il menu delle azioni.
  4. Fai clic su Rinomina specifica.
  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 facilitare la gestione e la sicurezza. Per spostare una specifica in una cartella, vedi Organizzare le specifiche utilizzando le cartelle.

Eliminare una specifica

Puoi eliminare una specifica dal datastore di file quando non è più necessaria o non è più valida.

Per eliminare una specifica:

  1. Seleziona Sviluppa > Specifiche nel menu di navigazione laterale.
  2. Posiziona il cursore sulla specifica da eliminare per visualizzare il menu delle azioni.
  3. Fai clic su Icona Elimina.
  4. Fai clic su Elimina per confermare l'operazione di eliminazione al prompt.
  5. Elimina gli artefatti correlati che non sono più necessari.