Rezepte: erster IBAN-API-Aufruf in Ihrer Programmiersprache
Mit einer Formatprüfung ohne Schlüssel beginnen
Dieser kostenlose Aufruf prüft Aufbau und Prüfziffer. Er sendet das Dokumentationsbeispiel an die API, ohne Bankabfrage und ohne Schlüsselerstellung:
curl --silent --show-error --fail-with-body --max-time 15 \
--get --data-urlencode 'iban=DE89370400440532013000' \
https://api.ibanforge.com/v1/iban/formatFür die folgenden Beispiele mit Bankinformationen einmal einen Schlüssel erstellen, aufbewahren und IBANFORGE_API_KEY in der Serverumgebung setzen. Das tatsächlich zurückgegebene Kontingent und den Nutzungsbericht lesen; Schutzmassnahmen können das anfängliche Kontingent reduzieren. Der Schlüssel gehört weder in Browsercode noch ins Repository oder eine Tabellenzelle. Erster Test · Aktuelle Preise.
Jedes Beispiel sendet eine einzelne Validierungsanfrage und zeigt das Ergebnis, ohne eine Zahlung zu entscheiden. Die IBAN wird an die API übertragen; für den Test die Dokumentationsbeispiele verwenden. Eine Ausnahme beendet das Skript: Netzwerkfehler, Zeitüberschreitung und HTTP 402/429/5xx sind kein valid: false. Es gibt keine automatische Schlüsselerstellung, keinen Kauf und keine Wiederholung.
Python
Das offizielle SDK mit python -m pip install ibanforge installieren und diesen Code als Python-Skript speichern:
import json
import os
from ibanforge import IBANforge
key = os.environ.get("IBANFORGE_API_KEY", "").strip()
if not key:
raise RuntimeError("IBANFORGE_API_KEY vor diesem Aufruf setzen")
with IBANforge(api_key=key, timeout=15) as client:
result = client.validate_iban("DE89370400440532013000")
print(json.dumps(result, ensure_ascii=False, indent=2))Für direkten HTTP-Zugriff requests mit python -m pip install requests installieren. Vor dem Ergebnis den HTTP-Status prüfen; diese Ausgabe erhält alle empfangenen JSON-Felder:
import json
import os
import requests
key = os.environ.get("IBANFORGE_API_KEY", "").strip()
if not key:
raise RuntimeError("IBANFORGE_API_KEY vor diesem Aufruf setzen")
response = requests.post(
"https://api.ibanforge.com/v1/iban/validate",
json={"iban": "DE89370400440532013000"},
headers={"Authorization": f"Bearer {key}"},
timeout=15,
allow_redirects=False,
)
response.raise_for_status()
if response.status_code != 200:
raise RuntimeError(f"Unerwartete HTTP-Antwort: {response.status_code}")
result = response.json()
if not isinstance(result, dict) or not isinstance(result.get("valid"), bool):
raise RuntimeError("Unvollständige Validierungsantwort")
print(json.dumps(result, ensure_ascii=False, indent=2))HTTP-Fehler des SDK leiten sich von IBANforgeError ab; Netzwerkfehler und Zeitüberschreitungen bleiben httpx-Ausnahmen. Bei requests leiten sie sich von requests.RequestException ab. Die Skripte lassen Fehler weiterlaufen, ohne ein falsches Ergebnis auszugeben.
Node.js / TypeScript
Mit Node.js 20 oder neuer als erster-aufruf.mjs speichern und node erster-aufruf.mjs ausführen. Das integrierte fetch benötigt kein Zusatzpaket. Das offizielle TypeScript-SDK bietet auch Typen und eigene Fehlerklassen.
const key = process.env.IBANFORGE_API_KEY?.trim();
if (!key) throw new Error("IBANFORGE_API_KEY vor diesem Aufruf setzen");
const response = await fetch("https://api.ibanforge.com/v1/iban/validate", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${key}`,
},
body: JSON.stringify({ iban: "DE89370400440532013000" }),
signal: AbortSignal.timeout(15_000),
redirect: "error",
});
if (!response.ok) throw new Error(`HTTP-Fehler: ${response.status}`);
const result = await response.json();
if (!result || typeof result.valid !== "boolean") {
throw new Error("Unvollständige Validierungsantwort");
}
console.log(JSON.stringify(result, null, 2));PHP
Mit PHP 8 oder neuer und aktivierter cURL-Erweiterung als erster-aufruf.php speichern und php erster-aufruf.php ausführen. Ein HTTP-Fehler oder unvollständiges JSON beendet das Skript vor einer Ergebnisausgabe:
<?php
$key = trim(getenv("IBANFORGE_API_KEY") ?: "");
if ($key === "" || str_contains($key, "\r") || str_contains($key, "\n")) {
throw new RuntimeException("IBANFORGE_API_KEY vor diesem Aufruf setzen");
}
$request = curl_init("https://api.ibanforge.com/v1/iban/validate");
curl_setopt_array($request, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer " . $key],
CURLOPT_POSTFIELDS => json_encode(["iban" => "DE89370400440532013000"], JSON_THROW_ON_ERROR),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_TIMEOUT => 15,
]);
$body = curl_exec($request);
$status = curl_getinfo($request, CURLINFO_HTTP_CODE);
if ($body === false) throw new RuntimeException("Netzwerkantwort nicht verfügbar");
if ($status !== 200) throw new RuntimeException("HTTP-Fehler: " . $status);
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!is_array($result) || !is_bool($result["valid"] ?? null)) {
throw new RuntimeException("Unvollständige Validierungsantwort");
}
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;Java
Mit Java 17 oder neuer das veröffentlichte SDK 1.8.1 zum Maven-Projekt hinzufügen. Jackson ist eine Abhängigkeit des SDK:
<dependency>
<groupId>com.ibanforge</groupId>
<artifactId>ibanforge-sdk</artifactId>
<version>1.8.1</version>
</dependency>Diese Klasse im Projekt als ErsterAufruf.java speichern:
import com.ibanforge.sdk.IBANforge;
import com.ibanforge.sdk.model.IBANValidationResult;
import java.time.Duration;
public class ErsterAufruf {
public static void main(String[] args) {
String key = System.getenv("IBANFORGE_API_KEY");
if (key == null || key.isBlank()) {
throw new IllegalStateException("IBANFORGE_API_KEY vor diesem Aufruf setzen");
}
IBANforge client = IBANforge.builder()
.apiKey(key.trim()).timeout(Duration.ofSeconds(15)).build();
IBANValidationResult result = client.validateIban("DE89370400440532013000");
System.out.println(result.valid());
System.out.println(result.bic() == null ? null : result.bic().code());
System.out.println(result.bankCodeCheck());
}
}Ein fehlender BIC erscheint als null. bankCodeCheck() erhält die im Modell verfügbaren Felder, darunter Register und Datum. SDK-Fehler beenden das Beispiel. Die Modelle dieser Version enthalten nicht alle API-Ergänzungen, etwa bestimmte Hinweise und Metadaten; für das vollständige JSON einen HTTP-Client verwenden. README und Methoden.
C# / .NET
In einem .NET-8-Konsolenprojekt das veröffentlichte Paket 1.8.1 installieren:
dotnet add package IBANforge.Sdk --version 1.8.1Den Inhalt von Program.cs durch dieses Beispiel ersetzen:
using IBANforge.Sdk;
using System.Text.Json;
var key = Environment.GetEnvironmentVariable("IBANFORGE_API_KEY");
if (string.IsNullOrWhiteSpace(key))
throw new InvalidOperationException("IBANFORGE_API_KEY vor diesem Aufruf setzen");
using var client = new IBANforgeClient(new IBANforgeOptions {
ApiKey = key.Trim(),
Timeout = TimeSpan.FromSeconds(15),
});
var result = await client.ValidateIbanAsync("DE89370400440532013000");
Console.WriteLine(JsonSerializer.Serialize(new {
valid = result.Valid,
bic = result.Bic,
bank_code_check = result.BankCodeCheck,
}));Fehlende Felder bleiben null; eine Ausnahme verhindert die Ergebnisausgabe. Diese Ausgabe ist eine Auswahl der Modellfelder und nicht das vollständige API-JSON. Eine bestehende Anwendung kann auch ihren eigenen HttpClient übergeben. README und Modellgrenzen.
Google Sheets
Die offiziellen Funktionen speichern den Schlüssel in Ihren Nutzereigenschaften und senden Spalten in Batches. Kein Schlüssel gehört in eine Zelle.
- Laden Sie die drei Apps-Script-Dateien herunter und entpacken Sie das ZIP. Öffnen Sie in einer Testtabelle Erweiterungen → Apps Script.
- Ersetzen Sie
Code.gs, fügen Sie eine HTML-Datei namensSidebarhinzu und übernehmen SieSidebar.html. Blenden Sieappsscript.jsonin den Projekteinstellungen ein und ersetzen Sie den Inhalt durch das mitgelieferte Manifest. Speichern. - Führen Sie
ibfShowSidebarim Editor aus und autorisieren Sie das Script. Zurück in der Tabelle speichern Sie Ihren Schlüssel in der Seitenleiste, niemals in einer Zelle. - Importieren Sie diese beiden Test-IBANs in Spalte A über Datei → Importieren. Es sind ein öffentliches Dokumentationsbeispiel und seine Variante mit falscher Prüfziffer, keine Zahlungskonten. In B2 geben Sie
=IBAN_PRUEFUNG(A2:A3)ein und lassen fünf Spalten frei. - Prüfen Sie beide Zeilen:
TRUEfür das erste Format,FALSEfür das zweite. Danach Bank, BIC, Bankcode-Ergebnis und SEPA lesen. Fehlende Felder sind keine Zahlungsfreigabe.
Zwei IBANs verbrauchen zwei Kontingenteinheiten. Der Cache kann erneute Anfragen bis zu sechs Stunden vermeiden; seine Aufbewahrung ist nicht garantiert. Manuelle Installation; dieser Download ist kein Eintrag im Google Workspace Marketplace. Alle Funktionen und Grenzen.
n8n
Erster Test auf n8n Cloud oder eigenem Server
- Workflow-JSON herunterladen und Import from File im n8n-Workflow-Menü wählen. Es enthält nur zwei integrierte Nodes: Manual Trigger und HTTP Request. Keine Erweiterung und kein Schlüssel sind enthalten.
- Contrôler l’exemple de documentation öffnen: POST an
/v1/iban/validate, JSON mit dem öffentlichen BeispielDE89370400440532013000. Einmal manuell ausführen. - In der Ausgabe
valid,bank_code_checkund verfügbare Quellen prüfen. Der Workflow führt weder Zahlungen noch Folgeaktionen aus. HTTP-Fehler, erschöpftes Kontingent und Zeitüberschreitungen stoppen den Schritt. - Für Ihr eigenes Schlüsselkontingent im HTTP-Node Generic Credential Type → Header Auth wählen: Name
Authorization, WertBearergefolgt von Ihrem Schlüssel. Den Schlüssel in den Zugangsdaten speichern, niemals im exportierten JSON.
Der Test ohne Schlüssel verwendet das REST-Kontingent aus der Startanleitung, gemeinsam pro Netzwerkadresse. n8n-Cloud-Nutzer können eine Adresse teilen; bei erschöpftem Kontingent Ihren Schlüssel konfigurieren. Workflow importieren · HTTP-Request-Optionen.
Lieferantendaten vor einem ERP-Import prüfen
Prüfworkflow herunterladen, um die Originalzeilen zu erhalten und eine JSON-Datei mit Befunden zu erstellen. Er verwendet integrierte Nodes und einen API-Schlüssel, ohne Community-Erweiterung. Import und Ausführung wurden mit n8n 2.46.6 geprüft; Node-Namen und Hinweise auf der Arbeitsfläche sind auf Französisch. Die Ausführung auf n8n Cloud wurde nicht getestet.
- Die Datei in einen neuen Workflow importieren. In Contrôler les IBAN avec la clé Zugangsdaten vom Typ Header Auth wählen:
Authorization, dannBearergefolgt von Ihrem API-Schlüssel. Den Schlüssel niemals in das exportierte Workflow-JSON schreiben. - Die vier erfundenen Beispielzeilen ausführen. Sie zeigen fehlerhafte IBANs, eine Zeile ohne IBAN und ein Duplikat; sie gehören zu keinem echten Lieferanten.
- In Télécharger la revue JSON die Ausgabe Binary, Feld
data, öffnen und die Datei speichern. Der vorherige Node zeigt die Befunde je Zeile. - Für eigene Daten Lignes fictives à remplacer durch eine JSON-Quelle mit 1 bis 100 Zeilen ersetzen, mit
ibanals Text.bicundbank_namesind optional; weitere Spalten bleiben inoriginalerhalten.
Vorschläge bleiben in review.proposal, getrennt von den Originalwerten. ask_supplier meldet eine konkrete Auffälligkeit; review bewahrt Unsicherheiten, fehlende Felder oder Duplikate; enrichment_proposal enthält nur vorgeschlagene Felder mit ihren Quellen. Eine nicht identifizierte Bank wird niemals als bestätigt behandelt. Kein Status gibt eine Zahlung frei.
Nur IBANs werden an die API gesendet. Der Stapel verbraucht eine Kontingenteinheit je IBAN, auch bei Duplikaten. HTTP-Fehler, ein erschöpftes Kontingent oder widersprüchliche Antworten stoppen den Workflow ohne neue Datei, automatische Wiederholung oder Kauf. Zeilen ohne IBAN bleiben ohne API-Aufruf zur Prüfung erhalten. Originaldaten und Berichte verbleiben in n8n und dessen Ausführungshistorie: Die Aufbewahrung vor der Nutzung echter Daten passend einstellen.
Community-Erweiterung für selbst gehostetes n8n
Das veröffentlichte Paket n8n-nodes-ibanforge@0.1.3 bietet IBAN-Validierung, BIC-Suche, Schweizer Clearing und Compliance-Vorprüfungen auf Bankebene. Dieses Rezept gilt für selbst gehostetes n8n, mit einem Owner- oder Admin-Konto. Die Installation eines Pakets aus npm ist auf n8n Cloud nicht verfügbar; dort ist ein verifizierter Eintrag erforderlich. Siehe die Installationsanleitung von n8n.
- Settings → Community nodes → Install öffnen und
n8n-nodes-ibanforge@0.1.3eingeben. - Einen kostenlosen API-Schlüssel beziehen (25 Anfragen/Monat ohne E-Mail, 200 nach Beanspruchung, ohne Karte). In einem neuen Workflow Manual Trigger mit IBANforge verbinden und den Schlüssel in den Zugangsdaten IBANforge API hinterlegen.
- Validate IBAN auswählen, das Dokumentationsbeispiel
DE89370400440532013000eingeben und den Schritt ausführen. - Die JSON-Ausgabe prüfen:
validsollte für dieses Beispieltruesein,bank_code_checkbeschreibt das Registerergebnis undbicdie Bank, sofern sie ermittelt werden kann. Eine abgeschlossene Operation mit diesen Feldern belegt den ersten API-Aufruf; ein grüner Verbindungstest allein genügt nicht.
In Version 0.1.3 ruft der Verbindungstest den öffentlichen Endpunkt /v1/demo auf, der den Schlüssel nicht prüft. Vor dem Einsatz des Workflows das tatsächliche Ergebnis von Validate IBAN kontrollieren. Weder ein gültiges Format noch eine identifizierte Bank belegen, dass das Konto existiert oder einem bestimmten Zahlungsempfänger gehört.
Für eine manuelle Installation die folgenden Befehle als Benutzer des n8n-Dienstes ausführen, gegebenenfalls in dessen Container. Anschliessend n8n neu starten:
mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install n8n-nodes-ibanforge@0.1.3Der Node verarbeitet jedes eingehende Element einzeln; er hat keine Batch-Operation. Eine Liste mit 100 Elementen kann daher 100 Anfragen verbrauchen. Details zur manuellen Installation.
Odoo
Das öffentliche Odoo-Modul, Version 18.0.1.0.0 (AGPL-3), füllt BIC und Bankname aus, wenn die API sie ermitteln kann. Es benötigt Odoo 18 mit Unterstützung für eigene Python-Module, auf Ihrem eigenen Server oder auf Odoo.sh. Odoo Online unterstützt diese Module nicht. Diese Installation verwendet das Quellcode-Repository und ist nicht von einem Eintrag im Odoo Apps Store abhängig.
Auf Ihrem eigenen Odoo-Server das Repository in ein Verzeichnis Ihrer Wahl klonen:
git clone --branch 18.0 --single-branch https://github.com/cammac-creator/ibanforge-odoo.git /path/to/ibanforge-odoo/path/to/ibanforge-odoo zur bestehenden addons_path-Liste von Odoo hinzufügen und die anderen Einträge beibehalten. Das Modul liegt im Unterverzeichnis: Das Manifest muss unter /path/to/ibanforge-odoo/ibanforge_bank_autofill/manifest.py liegen. Alternativ nur dieses Verzeichnis ibanforge_bank_autofill in ein bereits konfiguriertes Addons-Verzeichnis kopieren. Die Python-Bibliothek requests muss in der Odoo-Umgebung verfügbar sein. Auf Odoo.sh dieses Modulverzeichnis nach der Anleitung für eigene Module zum Projekt hinzufügen.
- Odoo neu starten, den Entwicklermodus aktivieren und die Apps-Liste aktualisieren. Bei Bedarf den Standardfilter Apps entfernen, dann IBANforge Bank Auto-fill (
ibanforge_bank_autofill) installieren. - Einstellungen → IBANforge öffnen, Ihren API-Schlüssel einfügen und die Einstellungen speichern. Die voreingestellte API-Adresse beibehalten. Ohne Schlüssel sendet das Modul keine Netzwerkanfragen.
- In einer Testdatenbank ein Partner-Bankkonto mit
DE89370400440532013000anlegen. Das Bankfeld leer lassen, die IBAN eingeben und das Feld verlassen. Die erkannte Bank und den BIC oder die verknüpfte Bank prüfen, speichern und das Konto erneut öffnen, um die gespeicherte Bankverknüpfung zu kontrollieren.
Wenn die API nicht erreichbar ist oder kein BIC gefunden wird, bleibt die automatische Ergänzung aus; das Speichern wird dadurch nicht blockiert. Odoos Modul base_iban prüft weiterhin das IBAN-Format. Beim Speichern bleibt eine bereits eingetragene Bank erhalten. Eingabe und Speichern eines neuen Kontos können zwei API-Aufrufe benötigen: 200 monatliche Anfragen entsprechen daher nicht 200 manuell erfassten Konten. Die IBAN wird an die konfigurierte API übermittelt; das Ergebnis belegt keine Kontoinhaberschaft. Verhalten und Grenzen des Moduls.
KI-Agenten (MCP)
Remote MCP: https://api.ibanforge.com/mcp in einem kompatiblen Client hinzufügen. Für einen lokalen Prozess:
npx -y ibanforge-mcpOder der gehostete Transport, ohne Installation: https://api.ibanforge.com/mcp — 25 kostenlose Tool-Aufrufe pro Woche und Quelladresse, ganz ohne Schlüssel (ISO-Woche in UTC, Neustart montags um 00:00 UTC): der schnellste Weg für einen Assistenten, die Daten zu prüfen, bevor Sie sich festlegen. Mit Ihrem Schlüssel im Header Authorization: Bearer zählen seine Aufrufe genau wie bei der REST-API auf diesen Schlüssel (wohin damit).
Das Ergebnis vor der Integration lesen
Bank, BIC, Quellen und Daten hängen von der erhaltenen Antwort ab. Kein fester Bankname ist Voraussetzung für den Erfolg dieser Rezepte.
| Feld | Einordnung |
|---|---|
valid | Prüfung der IBAN, getrennt vom Bankcode-Ergebnis. Ein HTTP-Fehler ist kein ungültiges Ergebnis. |
bic | Bankidentifikation, falls verfügbar; null bleibt unbekannt. |
bank_code_check | Status, Grund, Quelle und Datum der verwendeten Referenz. Ein Teilregister kann das Fehlen einer Bank nicht beweisen. |
bank_code_holder, Metadaten und Rückzugsfelder | Zusätzliche Felder der HTTP-Antwort; prüfen, ob die verwendete SDK-Modellversion sie enthält. |
Diese Prüfungen belegen weder die Existenz noch den Inhaber eines Kontos. Gelieferte Bankdaten nicht automatisch ersetzen. Antwort und Herkunft im eigenen Prüfablauf erhalten und die Aufbewahrung an die Daten anpassen.
Vollständige Antwort und Grenzen · IBAN zu BIC · Stapelverarbeitung · Fehler · Test-IBANs
Nutzen Sie die Prüfungen für Ihren Anwendungsfall
Wählen Sie den ersten Schritt für Ihre Software oder Ihre Lieferantendatei.
IBAN-Prüfungen in Ihre Software integrieren
Testen Sie eine Validierung, sehen Sie sich die Antwort an und verbinden Sie Ihre Anwendung über die API oder eine vorhandene Integration.
API-Ablauf ansehenEine Lieferantendatei prüfen
Laden Sie eine CSV- oder Excel-Datei hoch und sehen Sie die Ergebnisse kostenlos in der Vorschau. Bei Bedarf kaufen Sie die kommentierte Arbeitsmappe. Ohne Konto oder Abonnement.
Dateiprüfung kennenlernenDie verfügbaren Bankinformationen hängen von Land und Quelle ab. Diese Prüfungen bestätigen weder den Kontoinhaber noch die erfolgreiche Ausführung einer Zahlung.