Catturare gli errori del connettore HTTP

Comprendere i casi d'uso della cattura di un errore del connettore API HTTP, nonché come registrare l'errore e riprovare la funzione del connettore.

Tipi di errori del connettore HTTP

Lo standard del protocollo HTTP prevede un codice di risposta e un messaggio del server, noti come Codice di risposta HTTP e Messaggio di risposta HTTP. Esistono quindi classi di codici di risposta HTTP standard, o categorie, per aiutare gli utenti finali a indicare in modo intuitivo il tipo di errore verificatosi.
Queste classi di codici includono i seguenti: * 1xx - risposta informativaLa richiesta è stata ricevuta, continua il processo * 2xx - successoLa richiesta è stata ricevuta, compresa e accettata con successo * 3xx - reindirizzamentoÈ necessario intraprendere ulteriori azioni per completare la richiesta * 4xx - errore del clientLa richiesta contiene una sintassi errata o non può essere soddisfatta * 5xx - errore del serverIl server non è riuscito a soddisfare una richiesta apparentemente valida.

Il codice di errore più comune che si può incontrare è 404 - Not Found o 500 - Internal Server Error. Questi codici di errore possono indicare che il server del sistema esterno è inattivo, che è in corso una manutenzione, che c'è un problema con il servizio o che c'è un problema di rete.

Esempio: Catturare gli errori HTTP in un'applicazione

L'esempio seguente spiega come configurare un'applicazione per visualizzare gli errori della funzione connettore HTTP.

Creare la funzione connettore

Nel costruttore di funzioni del connettore, è possibile mappare il codice di errore HTTP e il messaggio di errore nella configurazione del connettore Output. Questo passerà il Codice di errore HTTP e il Messaggio di errore come output della funzione connettore da usare successivamente nelle app Tulip.

1. Mappare i campi di stato HTTP in output.
2. Assegnare alle uscite un nome chiaro e distinto e rieseguire la funzione connettore per verificare se l'uscita appare correttamente.

L'aspetto sarà quello dell'esempio seguente:

Creare un'applicazione per gestire gli errori del connettore

Utilizzate le informazioni delle uscite del connettore nelle applicazioni per gestire gli errori del connettore.

Eseguire il connettore in un trigger di app

Creare un'azione di trigger con Esegui funzione connettore. Selezionare il connettore e la funzione appena costruita, quindi salvare il risultato come variabile.

Il Codice di risposta HTTP e il Messaggio sono ora disponibili come riferimento nella nuova variabile dell'app.

Visualizzare la risposta del connettore in un'applicazione

Posizionare un widget Variabile in un passo dell'applicazione che visualizzi l'intera variabile Risposta del connettore.

Creare un trigger per la gestione degli errori del Connector

Successivamente, è possibile utilizzare il codice di risposta HTTP per eseguire la gestione degli errori a livello di app su una condizione di trigger successiva.

1. Creare un nuovo trigger per eseguire la gestione degli errori del connettore.
2. Creare una condizione che cerchi i codici di risposta HTTP non corretti. In questo esempio, la condizione cerca le risposte che non sono uguali a 200.:::(Info) (Nota) Molti sistemi utilizzano un codice di risposta 200 come una buona risposta, ma è meglio verificare con il fornitore dell'endpoint API o con l'IT se tutte le risposte buone saranno solo di codice 200 :::
3. Creare un'azione di trigger che si verifichi quando la condizione è soddisfatta, quando il codice di risposta HTTP è negativo.

Ecco come appare nell'applicazione:

Ulteriori letture

• Come creare e configurare una funzione del connettore HTTP
• Come formattare gli output del connettore HTTP
• Usare i connettori HTTP nelle applicazioni