Catturare gli errori del connettore HTTP

Capire 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.Queste classi di codici includono i seguenti:* 1xx - risposta informativaLarichiesta è stata ricevuta, continua il processo* 2xx - successoLarichiesta è stata ricevuta, compresa e accettata con successo* 3xx - reindirizzamentoÈnecessario intraprendere ulterioriazioni per completare la richiesta* 4xx - errore del clientLarichiesta contiene una sintassi errata o non può essere soddisfatta* 5xx - errore del serverIlserver 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. Dare alle uscite un nome chiaro e distinto e rieseguire la funzione connettore per verificare se l'uscita appare correttamente.

Il risultato sarà quello dell'esempio seguente:

Creare un'applicazione per gestire gli errori del connettore

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

Eseguire il connettore in un trigger dell'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'applicazione.

Visualizzare la risposta del connettore in un'applicazione

Collocare un widget Variable in un passo dell'applicazione che visualizzi l'intera variabile Connector Response.

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) (Note)
   Many systems use a 200 response code as a good response, but it is best to check with the API endpoint provider or IT if all good responses will only be of code 200
   :::
3. Creare un'azione di attivazione che si verifichi quando la condizione è soddisfatta, quando il codice di risposta HTTP è errato.

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