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

# Вступ

> API перевірки банківських реквизитів Cleariflow забезпечує комплексну перевірку міжнародних банківських рахунків (IBAN) і банківських ідентифікаційних кодів (BIC) через сучасний RESTful JSON-інтерфейс — з підтримкою понад 50 країн.

## Початок роботи

<Card title="Перевірка IBAN" icon="credit-card" href="bank-validation/iban">
  Ендпоінт `iban` перевіряє міжнародні банківські рахунки (IBAN) з повною перевіркою за країною, контролем формату та детальною структурною інформацією для фінансових застосунків.
</Card>

<Card title="Перевірка BIC" icon="building" href="bank-validation/bic">
  Ендпоінт `bic` перевіряє банківські ідентифікаційні коди (BIC) і надає детальну розбивку банківських кодів, інформації про країну та типів установ для міжнародних банківських операцій.
</Card>

<Card title="Підтримувані країни" icon="globe" href="bank-validation/countries">
  Повний список підтримуваних країн для перевірки IBAN і BIC, включаючи коди країн, інформацію про валюту та специфічні вимоги до форматування.
</Card>

### REST-архітектура

API перевірки банківських реквизитів дотримується принципів REST, використовуючи передбачувані URL, орієнтовані на ресурси, та стандартні HTTP-коди статусу для безперебійної інтеграції та обробки помилок.

### Безпека HTTPS

Усі API-з'єднання захищені протоколами шифрування TLS 1.2 або вище для забезпечення цілісності та конфіденційності даних.

### Версіонування API

API перевірки банківських реквизитів підтримує зворотну сумісність через версіонування, наразі працює у версії 1 з запланованими майбутніми покращеннями.

### Автентифікація

API-ключ є єдиним обліковим даним для доступу до API перевірки банківських реквизитів. Кожен сервіс Cleariflow потребує унікального ключа, що забезпечує безпечний та ізольований доступ між різними API.

## Коди відповідей і помилок

Якщо запити не вдаються, API повертає структуровані JSON-відповіді з помилками, що містять конкретні коди та описи для ефективного усунення несправностей.

| Code | Type                  | Details                                                                                                           |
| ---- | --------------------- | ----------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Усе працювало як очікувалося.                                                                                     |
| 400  | Bad request           | Некоректний запит — відсутні або недійсні параметри.                                                              |
| 401  | Unauthorized          | Запит неприйнятний. Зазвичай через відсутній або неправильний API-ключ.                                           |
| 422  | Quota reached         | Запит перервано через недостатню кількість API-кредитів. (Безкоштовні тарифи)                                     |
| 429  | Too many requests     | Запит перервано через досягнення ліміту запитів на секунду. На безкоштовних тарифах запити обмежені 1 на секунду. |
| 500  | Internal server error | Запит не може бути виконаний через помилку на сервері.                                                            |
| 503  | Service unavailable   | Сервер був недоступний.                                                                                           |