Condividi tramite


Esportare la definizione dell'API in Postman per il test, il monitoraggio e lo sviluppo dell'API

SI APPLICA A: Tutti i livelli di Gestione API

Per migliorare lo sviluppo delle API, è possibile esportare il front-end di un'API in Gestione API in Postman. Esportare una definizione API da Gestione API come raccolta Postman in modo da poter usare gli strumenti di Postman per progettare, documentare, testare, monitorare e collaborare alle API.

Nota

Solo la definizione API può essere esportata direttamente da Gestione API a Postman. Altre informazioni, ad esempio criteri o chiavi di sottoscrizione, non vengono esportate.

Prerequisiti

  • Completare la guida introduttiva seguente: Creare un'istanza di Gestione API di Azure.

  • Assicurarsi che l'istanza gestisca un'API che si vuole esportare in Postman.

    Nota

    Attualmente, è possibile esportare solo le API HTTP da Gestione API direttamente a Postman.

  • Un account Postman, che è possibile usare per accedere a Postman per il Web.

Passare all'istanza di Gestione API

  1. Nel portale di Azure cercare e selezionare Servizi gestione API:

    Screenshot che mostra i servizi gestione API nei risultati della ricerca.

  2. Nella pagina Servizi Gestione API selezionare l'istanza di Gestione API:

    Screenshot che mostra un'istanza di Gestione API nella pagina Servizi Gestione API.

Esportare un'API in Postman

  1. Nel portale, in API, selezionare un'API.

  2. Nel menu di scelta rapida (...) selezionareEsporta>Postman.

  3. Nella finestra di dialogo Esegui in selezionare il percorso Postman in cui eseguire l'esportazione. È possibile selezionare l'opzione per l'app desktop se è stata installata in locale.

  4. In Postman selezionare un'area di lavoro Postman in cui importare l'API. Il valore predefinito è Area di lavoro personale.

  5. In Postman selezionare Genera raccolta da questa API per generare automaticamente una raccolta dalla definizione dell'API. Se necessario, configurare le opzioni di importazione avanzate, o accettare valori predefiniti. Seleziona Importa

    La raccolta e la documentazione vengono importate in Postman.

    Screenshot della raccolta importata in Postman.

Sviluppo di API con Gestione API e Postman

Gli sviluppatori di API possono eseguire rapidamente l'iterazione delle modifiche all'API usando le funzionalità di test, monitoraggio e sviluppo dell'API di Postman.

Le API sviluppate in Postman possono quindi essere esportate e importate nuovamente in Gestione API come revisioni API. In questo modo è possibile sviluppare API in Postman e quindi distribuirle in Gestione API per l'accesso e la gestione di runtime. Ulteriori informazioni

Attenzione

Prestare attenzione quando si passano Gestione API chiavi di sottoscrizione o altri dati sensibili in Postman. Postman Vault è consigliabile archiviare i dati sensibili come segreti dell'insieme di credenziali nell'istanza di Postman, in modo da poter riutilizzare in modo sicuro i segreti nelle raccolte e nelle richieste.