Creazione di flussi per un'API da zero
È possibile creare flussi per un'API (noti anche come flussi API ) in App Connect. La configurazione definita fornisce un'API che espone una o più operazioni. È possibile utilizzare queste operazioni per richiamare un endpoint e passare i dati tra questo e le applicazioni del flusso.
Prima di iniziare
- Se si conoscono le applicazioni o le API importate di cui si ha bisogno, creare gli account nella pagina App Connect Applicazioni e API per i connettori che eseguono operazioni API contro le applicazioni o le API di destinazione. È possibile creare account anche quando si crea un flusso. Per ulteriori informazioni, vedere Connessione agli account.
- Per utilizzare l 'authoring unificato per creare flussi API gestibili in API Connect assicurarsi di soddisfare i seguenti requisiti.
- È necessario avere accesso a una API Connect capacità in IBM® webMethods Hybrid Integration. La API Connect può trovarsi nello stesso ambiente della propria capacità o in un ambiente diverso App Connect o in un ambiente diverso. In alternativa, è possibile utilizzare un'istanza di IBM API Connect Enterprise as a Service nella stessa regione dell'ambiente webMethods Hybrid Integration dell'ambiente. Per fornire un'istanza di prova di API Connect Enterprise as a Service dalla pagina iniziale App Connect dalla home page, fare clic su Gestisci flussi API utilizzando IBM API Connect.
- L'istanza API Connect deve essere configurata con almeno un servizio DataPower API Gateway registrato.
- L'istanza API Connect deve contenere almeno un'organizzazione di provider a cui si è autorizzati ad accedere. L'organizzazione provider deve includere un catalogo che contenga un'applicazione con un'organizzazione di consumatori proprietaria e un ID cliente.
- È necessario abilitare l'authoring unificato per la propria istanza. Nella scheda Designer dell'editor del flusso API, fare clic sull'icona Modifica impostazioni gateway API
, abilitare l'authoring unificato, quindi fare clic su Salva. (Se non si dispone di una funzionalità API Connect nell'ambiente webMethods Hybrid Integration o di un'istanza di API Connect Enterprise as a Service nella stessa regione dell'ambiente webMethods Hybrid Integration, l'icona Modifica impostazioni gateway API è disattivata)
Informazioni su questa attività
Quando si creano flussi per un'API, ogni singolo flusso è l'implementazione di un'operazione API che viene tipicamente richiamata dalle applicazioni mobili e web. (Esempi di operazioni sono "GET order" e "POST order") Il flusso per ogni operazione contiene una richiesta, azioni per una o più applicazioni o API importate e una risposta per l'operazione API. Il flusso può contenere anche nodi toolbox per l'elaborazione specializzata dei dati. La richiesta utilizza un modello definito dall'utente per richiedere la creazione, il recupero o la sostituzione di oggetti di dati nelle applicazioni. Quando la richiesta viene inviata, ogni applicazione o API di destinazione completa la propria azione. Il flusso restituisce quindi una risposta che conferma che le azioni sono state eseguite correttamente o restituisce i dati che erano stati richiesti.
- Si creano uno o più modelli che definiscono la struttura degli oggetti che si desidera creare o recuperare. È possibile creare fino a 10 modelli.
- Si possono scegliere le operazioni integrate di creazione, recupero, sostituzione o aggiornamento da completare con ciascun modello, oppure si possono definire operazioni personalizzate.
- Si configura un flusso per implementare ogni operazione e si aggiungono azioni per una o più applicazioni o API di destinazione. Si possono anche aggiungere al flusso le utilità del toolbox per elaborare i dati in ingresso o in uscita da queste applicazioni.
Se si dispone di un'istanza di API Connect nello stesso ambiente o regione della propria istanza App Connect si può esporre l'API in entrambi i formati App Connect e API Connect. Questa funzione è nota come authoring unificato. L'authoring unificato è disattivato per impostazione predefinita.
Con l'authoring unificato, quando si crea e si avvia un flusso API in App Connect l'API viene aggiunta automaticamente a un Prodotto. Il prodotto viene quindi pubblicato in un catalogo fornito a un'organizzazione di fornitori in un'apposita sezione API Connect. Il prodotto diventa visibile anche nel API Connect Developer Portal se il sito è abilitato per il catalogo. Le preferenze di pubblicazione si basano sull'utente che ha effettuato l'accesso. App Connect scopre automaticamente le organizzazioni di provider in API Connect che l'utente ha accesso nello stesso ambiente o regione dell'istanza App Connect istanza. È possibile specificare le impostazioni per la pubblicazione dell'API a un'istanza preferita API Connect e a un'organizzazione di provider preferita. È inoltre possibile scegliere i target del catalogo e del gateway, il prodotto e il piano contenenti l'API pubblicata e un'applicazione di consumo.
È possibile lavorare con l'API in API Connect indipendentemente dall'API in App Connect. È inoltre possibile consultare il prodotto (e l'API) nel portale degli sviluppatori. Quando si interrompe l'API in App Connect il Prodotto (e l'API) nell'interfaccia utente di API Manager e nel sito del Portale sviluppatori vengono eliminati automaticamente. (Un utente che non ha accesso a API Connect può interrompere il flusso in App Connect. Tuttavia, l'API rimane pubblicata in API Connect.)
Se si ha accesso a una funzionalità di API Connect in webMethods Hybrid Integration, o a un'istanza di IBM API Connect Enterprise as a Service nella stessa regione della propria istanza di App Connect istanza, è possibile abilitare l'authoring unificato. Quando l'authoring unificato è abilitato e si crea e si avvia un flusso API, il flusso viene pubblicato automaticamente su API Connect. Se si avvia un flusso API senza specificare le preferenze di pubblicazione, l'API viene pubblicata sul Piano predefinito in un Prodotto generato automaticamente in un catalogo sandbox in qualsiasi istanza scoperta API Connect istanze scoperte.
È possibile utilizzare l'editor API in App Connect per creare un flusso API e per definire modelli e implementare operazioni per la propria API. È inoltre possibile configurare le impostazioni dei criteri, del gateway e del portale per controllare il comportamento dell'API quando viene pubblicata su API Connect dopo l'avvio del flusso. Le operazioni seguenti descrivono come creare il flusso API, configurare le preferenze di pubblicazione e accedere all'API pubblicata in API Connect.
Creazione del flusso API in App Connect
Procedura
Per creare un flusso API, completare i seguenti passaggi.
Risultati
Cosa fare successivamente
- È possibile testare il comportamento dell'API prima di distribuirla. Per ulteriori informazioni, vedere Test di un'API.Nota: se l'authoring unificato è abilitato e si avvia il flusso prima di aver impostato le preferenze di pubblicazione per quel flusso, viene utilizzato l'ultimo set di preferenze utente salvate per un flusso. Se non sono state impostate preferenze in precedenza, l'API viene pubblicata sul Piano predefinito in un Prodotto generato automaticamente in un catalogo sandbox in una qualsiasi delle istanze scoperte API Connect istanze scoperte. Pertanto, per controllare dove viene pubblicata l'API, è necessario assicurarsi di specificare le impostazioni preferite prima di avviare l'API.Quando si testa un'API, nell'editor API è disponibile la scheda Test.
La definizione YAML di OpenAPI 3.0 per il flusso API in esecuzione in App Connect viene utilizzata per pubblicare automaticamente l'API su un Prodotto e un Piano nel catalogo e nell'organizzazione di provider specificati nella propria istanza API Connect istanza. Se è stato configurato un portale per sviluppatori, il prodotto API diventa visibile anche lì.Nota: Se è abilitato l'authoring unificato, l'API viene aggiunta a un prodotto generato automaticamente o a una versione indipendente del prodotto esistente selezionato, in base alle preferenze dell'utente. Il Prodotto pubblicato contiene solo la vostra API. - Quando si è pronti a eseguire il flusso in un ambiente di produzione, lo si distribuisce. Per ulteriori informazioni, vedere Distribuzione delle integrazioni.
Accedere all'API pubblicata in API Connect
Informazioni su questa attività
Procedura
Per accedere all'API in API Connect completare i seguenti passaggi.
e fai clic su 











, che è simile alla vista in cui si modificano le API in 



. Anche questa vista è di sola lettura e il sorgente YAML è conforme alla specifica OpenAPI 3.0.









