Gestisci le specifiche

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

Apigee Edge ti offre un luogo in cui archiviare le tue specifiche OpenAPI. Gestisci le specifiche OpenAPI, come descritto nelle sezioni seguenti.

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

Esplorare l'elenco delle specifiche

Per accedere all'elenco delle specifiche:

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

Viene visualizzato l'elenco corrente di specifiche e cartelle.

Elenco delle specifiche

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

Creare 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 + Specifica.
  3. Fai clic su Nuova specifica nel menu a discesa. Si apre l'editor delle specifiche.
  4. Sostituisci la specifica di esempio con i tuoi dettagli della specifica OpenAPI.
    Consulta Creare 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 Sviluppa > Specifiche nella barra di navigazione laterale.
  2. Fai clic su + Specifica.
  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 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 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.

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

Con Apigee Edge, puoi creare i proxy API dalle specifiche OpenAPI che progetti e salvi nell'editor delle specifiche. In pochi clic, avrai un proxy API in Apigee Edge con i percorsi, i parametri, i flussi condizionali e gli endpoint di destinazione generati automaticamente. Successivamente, 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 in modo che rifletta 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 la quale vuoi creare un proxy API per visualizzare il menu delle azioni.
  4. Fai clic su genera proxy. Viene aperta la procedura guidata Crea proxy e la pagina Dettagli 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 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 Sviluppa > Specifiche nel menu di navigazione laterale.
  2. Se necessario, vai alla cartella contenente la specifica.
  3. Posiziona il cursore del mouse sopra la 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 annullare.

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 file store quando non è più necessaria o diventa non valida.

Per eliminare una specifica:

  1. Seleziona Sviluppa > 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 Icona Elimina.
  4. Fai clic su Elimina per confermare l'operazione di eliminazione quando richiesto.
  5. Elimina gli elementi correlati non più necessari.