Початок роботи
Перевірка IBAN
Ендпоінт
iban перевіряє міжнародні банківські рахунки (IBAN) з повною перевіркою за країною, контролем формату та детальною структурною інформацією для фінансових застосунків.Перевірка BIC
Ендпоінт
bic перевіряє банківські ідентифікаційні коди (BIC) і надає детальну розбивку банківських кодів, інформації про країну та типів установ для міжнародних банківських операцій.Підтримувані країни
Повний список підтримуваних країн для перевірки IBAN і BIC, включаючи коди країн, інформацію про валюту та специфічні вимоги до форматування.
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 | Сервер був недоступний. |