> ## 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.

# Introduction

> L'API de validation bancaire Cleariflow offre une validation complète des numéros de compte bancaire international (IBAN) et des codes d'identification bancaire (BIC) via une interface JSON RESTful moderne, prenant en charge plus de 50 pays.

## Premiers pas

<Card title="Validation IBAN" icon="credit-card" href="bank-validation/iban">
  L'endpoint `iban` valide les numéros de compte bancaire international avec une validation complète spécifique à chaque pays, une vérification du format et des informations structurelles détaillées pour les applications financières.
</Card>

<Card title="Validation BIC" icon="building" href="bank-validation/bic">
  L'endpoint `bic` valide les codes d'identification bancaire, fournissant une ventilation détaillée des codes bancaires, des informations sur le pays et des types d'institution pour les opérations bancaires internationales.
</Card>

<Card title="Pays pris en charge" icon="globe" href="bank-validation/countries">
  Liste complète des pays pris en charge pour la validation IBAN et BIC, incluant les codes pays, les informations sur les devises et les exigences de formatage spécifiques.
</Card>

### Architecture REST

L'API de validation bancaire suit les principes REST, en utilisant des URL prévisibles orientées ressources et des codes de statut HTTP standard pour une intégration fluide et la gestion des erreurs.

### Sécurité HTTPS

Toutes les communications API sont sécurisées à l'aide de protocoles de chiffrement TLS 1.2 ou supérieur pour garantir l'intégrité et la confidentialité des données.

### Versionnage de l'API

L'API de validation bancaire maintient la rétrocompatibilité par le versionnage, fonctionnant actuellement en version 1 avec des améliorations futures prévues.

### Authentification

Votre clé API sert d'identifiant exclusif pour accéder à l'API de validation bancaire. Chaque service Cleariflow nécessite une clé unique, garantissant un accès sécurisé et isolé entre les différentes API.

## Codes de réponse et d'erreur

Lorsque les requêtes échouent, l'API renvoie des réponses d'erreur JSON structurées avec des codes et descriptions spécifiques pour un dépannage efficace.

| Code | Type                  | Détails                                                                                                                                                          |
| ---- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Tout a fonctionné comme prévu.                                                                                                                                   |
| 400  | Bad request           | Mauvaise requête — paramètres manquants ou invalides.                                                                                                            |
| 401  | Unauthorized          | La requête était inacceptable. Généralement due à une clé API manquante ou incorrecte.                                                                           |
| 422  | Quota reached         | La requête a été interrompue en raison de crédits API insuffisants. (Forfaits gratuits)                                                                          |
| 429  | Too many requests     | La requête a été interrompue car le nombre de requêtes autorisées par seconde a été atteint. Cela se produit sur les forfaits gratuits, limités à 1 par seconde. |
| 500  | Internal server error | La requête n'a pas pu être complétée en raison d'une erreur côté serveur.                                                                                        |
| 503  | Service unavailable   | Le serveur était indisponible.                                                                                                                                   |