Guida all’integrazione di IBAN-Test

Validare gli IBAN in n8n con un flusso di lavoro scaricabile

Importa un piccolo flusso manuale, configura le credenziali API IBAN-Test e indirizza gli esiti ai rami VALID o INVALID. Il modello verifica un IBAN alla volta e si arresta se non può ottenere un risultato affidabile.

Stato dei test: Il report incluso documenta 24 test offline superati con Node.js: casi di test JavaScript, normalizzazione, duplicati, limiti, classificazione rigorosa dei risultati, rifiuto di risposte contrastanti e configurazione e connessioni del flusso di lavoro. Le definizioni dei nodi sono state verificate rispetto alla documentazione ufficiale di n8n e al codice sorgente. Un runtime n8n installato e le credenziali API non erano disponibili. L'importazione, l'esecuzione in n8n, la mappatura degli elementi collegati e le chiamate API autenticate non sono quindi ancora testate. Prima di fare affidamento sul flusso di lavoro, esegui il test manuale descritto di seguito nella tua istanza.

Cosa fa il modello

Usali come punto di partenza prima di connettere un modulo cliente, una tabella o un database interno. Il flusso di lavoro si avvia manualmente e contiene quattro righe di esempio: un IBAN di esempio pubblicato, una variante con una cifra di controllo modificata, un duplicato e un valore vuoto. Rimuove gli spazi bianchi, converte le lettere in maiuscolo, salta i valori vuoti e raggruppa i duplicati. Le posizioni delle righe originali vengono mantenute in sourceRows, in modo che un risultato possa essere assegnato a più righe.

Sono consentiti dieci IBAN diversi e non vuoti per corsa. Se sono più di dieci, il flusso di lavoro si interrompe prima della prima richiesta; i valori in eccesso non vengono scartati silenziosamente. I valori mancanti o vuoti vengono saltati, ma i valori senza tipo stringa interrompono la preparazione. Anche una voce completamente vuota porta ad un arresto. Salva gli IBAN nella tua fonte come testo.

Per ogni IBAN rimanente viene effettuata una richiesta REST separata. Questa integrazione non utilizza un endpoint di raccolta REST: dieci IBAN diversi significano fino a dieci chiamate di assegni. La rimozione dei duplicati viene applicata in un'unica esecuzione. Un riavvio controlla nuovamente gli stessi valori. Tieni in considerazione lo documentazione dell’API IBAN-Test durante la pianificazione.

1. Importa il file del flusso di lavoro

Decomprimere il file ZIP e aprire un nuovo flusso di lavoro in n8n. Dal menu a tre punti in alto a destra, seleziona Import from File e poi iban-test-n8n-workflow.json. Salva il flusso di lavoro con un nome significativo. Questi passaggi corrispondono a Istruzioni per l'importazione del flusso di lavoro n8n.

Dovrebbero comparire nove nodi, a partire da Run manually. Il nodo centrale One IBAN at a time usa lotti di un elemento. L’uscita loop conduce alla richiesta HTTP e al classificatore, che torna al ciclo. L’uscita done conduce ai rami dei risultati. Non modificare questi collegamenti durante il test.

2. Memorizza il token API come dati di accesso

Apri Validate IBAN. L'autenticazione è impostata come Generic Credential Type con Header Auth. Crea credenziali di autenticazione dell'intestazione con i seguenti campi o seleziona quelli esistenti:

• Name: Authorization
• Value: Bearer YOUR_API_TOKEN. Sostituisci il segnaposto con il tuo token e mantieni lo spazio dopo Bearer.

Salva e seleziona queste credenziali. Il download non contiene intenzionalmente né un ID dati di accesso né un segreto. Memorizza il tuo token solo nel modulo delle credenziali, non nel codice di esempio o nei normali parametri del nodo. Vedi n8n riferimento alle credenziali della richiesta HTTP.

La richiesta è già configurata come POST https://www.iban-test.eu/api/v2/iban/validate. L'espressione per il corpo JSON è {{ { iban: $json.iban } }}. Viene richiesta una risposta JSON che includa lo stato HTTP in modo che il nodo successivo possa controllare sia la trasmissione che il risultato API. Le impostazioni sono descritte nello Documentazione del nodo di richiesta HTTP.

3. Esegui gli esempi manualmente

Apri Sample rows e controlla i valori di esempio. Quindi avvia l'intero flusso di lavoro tramite il suo trigger manuale. Dalle righe specificate vengono creati due elementi di query. Se l'API viene eseguita correttamente, l'esempio invariato dovrebbe apparire sotto VALID results, la variante con cifra di controllo modificata sotto INVALID results. Questi sono i risultati attesi dal tuo primo test dal vivo, non l'affermazione che il download è già stato testato con un account autenticato.

Per ogni elemento di output, seleziona iban, sourceRows, status e code. I rami attualmente terminano in nodi senza operazioni in cui è possibile visualizzare i risultati senza scrivere su un altro sistema. Sostituisci gli esempi con alcuni valori di test rilasciati prima di connettere una fonte dati reale.

Distinguere tra risultati dei test ed errori tecnici

La classificazione richiede un codice numerico intero e un campo di errore booleano. Il codice di autenticazione 4002, il codice quota 4003 e il codice di accesso bloccato 4004 interrompono il flusso. Un timeout, uno stato HTTP diverso da 200 o un contenuto di risposta errato non vengono mai registrati come IBAN non valido. La base è lo codici di risultato API documentati. Un IBAN valido non dimostra né la proprietà del conto né garantisce il pagamento.

Lo Nodo in loop sugli elementi attende la classificazione prima di richiedere l'articolo successivo. In caso di errore tecnico successivamente non verranno più richiesti gli IBAN e le filiali risultanti definitivamente non verranno eseguite. L'output del nodo precedente potrebbe essere ancora visibile nell'editor. Trattare l'esecuzione come incompleta.

Le ripetizioni automatiche sono disabilitate. Risolvere i problemi di autenticazione o quota prima del riavvio. Un riavvio manuale potrebbe consumare ulteriori chiamate per le righe che sono già state controllate. Se aggiungi tentativi in ​​un secondo momento per errori temporanei, limita il numero e i tempi di attesa. Non ripetere mai input o richieste non validi in un ciclo quando la quota è esaurita.

Prima di collegare i dati produttivi

Il modello disabilita il salvataggio dei dati e dell'avanzamento dell'esecuzione manuale riuscita e non riuscita. Controlla questo Impostazioni del flusso di lavoro dopo l'importazione. Gli IBAN e le risposte API possono ancora essere visibili durante l'esecuzione; Anche le regole di hosting, logging e backup svolgono un ruolo. Non aggiungere dati reali dei clienti ai nodi né condividere esportazioni di flussi di lavoro che contengono tali dati.

Dopo aver completato con successo il test manuale, collegare ciascun ramo dei risultati alla destinazione prevista. Conserva gli identificatori di origine e previeni record duplicati nelle esecuzioni ripetute. Aggiungi una pianificazione solo dopo aver determinato il fuso orario, il budget della quota, i messaggi di errore e il comportamento di riavvio.

Le istruzioni per Verifica IBAN su Fogli Google e Controllo di un CSV IBAN con Python forniscono ulteriori informazioni.