Erste Schritte
IBAN-Validierung
Der
iban-Endpunkt validiert International Bank Account Numbers mit umfassender länderspezifischer Prüfung, Formatkontrolle und detaillierten Strukturinformationen für Finanzanwendungen.BIC-Validierung
Der
bic-Endpunkt validiert Business Identifier Codes und liefert detaillierte Aufschlüsselungen von Bankcodes, Länderinformationen und Institutstypen für internationale Bankgeschäfte.Unterstützte Länder
Umfassende Liste der unterstützten Länder für IBAN- und BIC-Validierung, einschließlich Ländercodes, Währungsinformationen und spezifischer Formatierungsanforderungen.
REST-Architektur
Die Bankvalidierungs-API folgt REST-Prinzipien mit vorhersehbaren, ressourcenorientierten URLs und standardmäßigen HTTP-Statuscodes für nahtlose Integration und Fehlerbehandlung.HTTPS-Sicherheit
Alle API-Kommunikation wird mit TLS 1.2 oder höher verschlüsselt, um Datenintegrität und Datenschutz zu gewährleisten.API-Versionierung
Die Bankvalidierungs-API bleibt durch Versionierung abwärtskompatibel und befindet sich derzeit in Version 1 mit geplanten zukünftigen Erweiterungen.Authentifizierung
Ihr API-Schlüssel ist die ausschließliche Berechtigung für den Zugriff auf die Bankvalidierungs-API. Jeder Cleariflow-Dienst erfordert einen eigenen Schlüssel für sicheren und isolierten Zugriff.Antwort- und Fehlercodes
Bei fehlgeschlagenen Anfragen liefert die API strukturierte JSON-Fehlerantworten mit spezifischen Codes und Beschreibungen zur effektiven Fehlerbehebung.| Code | Typ | Beschreibung |
|---|---|---|
| 200 | OK | Alles funktionierte wie erwartet. |
| 400 | Bad request | Fehlerhafte Anfrage — fehlende oder ungültige Parameter. |
| 401 | Unauthorized | Die Anfrage war nicht zulässig — in der Regel fehlt der API-Schlüssel oder er ist ungültig. |
| 422 | Quota reached | Die Anfrage wurde abgebrochen, da nicht genügend API-Guthaben vorhanden ist (kostenlose Tarife). |
| 429 | Too many requests | Das Anfragenlimit pro Sekunde wurde erreicht. Bei kostenlosen Tarifen gilt ein Limit von 1 Anfrage pro Sekunde. |
| 500 | Internal server error | Die Anfrage konnte aufgrund eines Serverfehlers nicht abgeschlossen werden. |
| 503 | Service unavailable | Der Server war nicht verfügbar. |