Testare un'API con l'editor delle politiche

Modifica online

IBM® API Connect fornisce un ambiente di test di base nell'editor Politiche in modo da poter garantire che le tue API siano definite e implementate correttamente.

Informazioni su questa attività

Puoi completare questa attività utilizzando l'applicazione IU API Designer o utilizzando l'IU API Manager basata sul browser.

Nota:
  • Se stai testando un'API OpenAPI 2.0, puoi utilizzare lo strumento di test dell'editor delle politiche descritto in questa pagina oppure la scheda Test. Se stai testando un'API OpenAPI 3.0, è disponibile solo la scheda "Test"; consulta la sezione "Utilizzo della scheda 'Test' per il debug dell'API ".
  • Se si sta testando un'API che contiene riferimenti a proprietà dell'API, solo i riferimenti definiti all'interno dell'assembly dell'API vengono risolti e sostituiti con i valori corrispondenti quando si chiama l'API nello strumento di test dell'assembly. I riferimenti alle proprietà definiti al di fuori dell'assembly dell'API non vengono risolti durante il test. Per ulteriori informazioni sulle proprietà API, consultare la sezione "Impostazione delle proprietà API " ( OpenAPI 2.0 ) oppure la sezione "Impostazione delle proprietà API " ( OpenAPI 3.0 ).
  • A causa delle restrizioni relative alla condivisione delle risorse tra origini diverse ( CORS ), lo strumento di test dell'assemblaggio non può essere utilizzato con i browser Chrome o Safari sulla piattaforma macOS Catalina.

Procedura

Per verificare una API, completa la seguente procedura.
  1. Se utilizzi API Designer, imposta la modalità su "Online" dal menu "Opzioni Menu Opzioni " nella pagina principale.
  2. Nel riquadro di navigazione, fare clic su Icona di sviluppo nel riquadro di navigazione dell'interfaccia utente API "Sviluppo ", quindi selezionare la scheda "API".
  3. Fai clic sul titolo dell'API che vuoi utilizzare.
  4. Fare clic sulla scheda Gateway , quindi, sul quadro di navigazione, selezionare Politiche.
  5. Se si sta eseguendo il test dell'API per la prima volta e, quando è stata creata la definizione API, è stata selezionata l'opzione Attiva API , la configurazione del test sarà già configurata e sarà possibile procedere immediatamente al passo successivo per verificare l'API. Altrimenti, fai clic su Offline per attivare / disattivare l'API allo stato Online . Se stai testando nuovamente le tue API dopo averle modificate, le API modificate vengono ripubblicate automaticamente al momento del salvataggio.
  6. Fai clic sull'icona Test Icona Test (freccia destra).
    Nota:
    • L'icona Test è attiva solo se hai attivato la tua API allo stato Online , come descritto nel passo 5.
    • I dettagli relativi al catalogo, al prodotto, al piano e all'applicazione visualizzati nel riquadro "Configurazione" riflettono le preferenze di test API configurate; vedere Specificare le preferenze di test per un'API,
  7. Nella sezione Operazione , seleziona l'operazione API che vuoi verificare, quindi fai clic su Richiama.
    La risposta API viene visualizzata nella sezione Risposta .
    Nota: se ricevi un messaggio associato a un certificato non attendibile, procedi come segue:
    1. Clicca sul link indicato.
    2. Accetta il certificato.
    3. Torna all'ambiente di test.
    4. Fai nuovamente clic su "Invoke".
    Il messaggio segnala inoltre che la mancanza del supporto per l' CORS e sul server è una delle possibili cause dell'errore di connessione.