Начало работы
Проверка IBAN
Эндпоинт
iban проверяет международные банковские счета с учётом правил конкретной страны, проверкой формата и подробной структурной информацией для финансовых приложений.Проверка BIC
Эндпоинт
bic проверяет банковские идентификационные коды, предоставляя детальную разбивку банковских кодов, информации о стране и типах учреждений для международных банковских операций.Поддерживаемые страны
Полный список поддерживаемых стран для проверки IBAN и BIC, включая коды стран, информацию о валютах и требования к форматированию.
REST-архитектура
API проверки банковских реквизитов следует принципам REST: предсказуемые URL, ориентированные на ресурсы, и стандартные HTTP-коды статуса для интеграции и обработки ошибок.Безопасность HTTPS
Все соединения с API защищены TLS 1.2 или выше для целостности и конфиденциальности данных.Версионирование API
API проверки банковских реквизитов сохраняет обратную совместимость через версионирование; сейчас работает версия 1 с запланированными улучшениями.Аутентификация
API-ключ — единственные учётные данные для доступа к API проверки банковских реквизитов. Каждый сервис Cleariflow требует уникальный ключ для изолированного и безопасного доступа.Коды ответов и ошибок
При неудаче 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 | Сервер был недоступен. |