> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduzione
> L'API di validazione bancaria di Cleariflow offre una validazione completa degli International Bank Account Numbers (IBAN) e dei Business Identifier Codes (BIC) tramite un'interfaccia RESTful JSON moderna, con supporto per oltre 50 paesi e informazioni dettagliate su validazione e formattazione.
## Per iniziare
L'endpoint `iban` valida gli International Bank Account Numbers con validazione completa specifica per paese, controllo del formato e informazioni strutturali dettagliate per applicazioni finanziarie.
L'endpoint `bic` valida i Business Identifier Codes, fornendo una scomposizione dettagliata dei codici bancari, delle informazioni sul paese e dei tipi di istituto per le operazioni bancarie internazionali.
Elenco completo dei paesi supportati per la validazione IBAN e BIC, inclusi codici paese, informazioni sulle valute e requisiti di formattazione specifici.
### Architettura REST
L'API di validazione bancaria segue i principi REST, utilizzando URL prevedibili e orientati alle risorse e codici di stato HTTP standard per un'integrazione fluida e una gestione degli errori efficace.
### Sicurezza HTTPS
Tutte le comunicazioni API sono protette con protocolli di crittografia TLS 1.2 o superiore per garantire integrità e privacy dei dati.
### Versionamento API
L'API di validazione bancaria mantiene la retrocompatibilità tramite il versionamento, operando attualmente sulla versione 1 con miglioramenti futuri pianificati.
### Autenticazione
La tua chiave API funge da credenziale esclusiva per accedere all'API di validazione bancaria. Ogni servizio Cleariflow richiede una chiave univoca, garantendo accesso sicuro e isolato tra le diverse API.
## Codici di risposta ed errore
Quando le richieste falliscono, l'API restituisce risposte di errore JSON strutturate con codici e descrizioni specifici per una risoluzione efficace dei problemi.
| Code | Type | Details |
| ---- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200 | OK | Tutto ha funzionato come previsto. |
| 400 | Bad request | Richiesta non valida — parametri mancanti o non validi. |
| 401 | Unauthorized | La richiesta non è stata accettata. Di solito a causa di una chiave API mancante o errata. |
| 422 | Quota reached | La richiesta è stata interrotta per crediti API insufficienti. (Piani gratuiti) |
| 429 | Too many requests | La richiesta è stata interrotta perché è stato raggiunto il numero di richieste consentite al secondo. Succede sui piani gratuiti poiché le richieste sono limitate a 1 al secondo. |
| 500 | Internal server error | La richiesta non è stata completata a causa di un errore lato server. |
| 503 | Service unavailable | Il server non era disponibile. |