Руководство: интеграция Regexly API за 30 минут

Финансовая точность в каждой транзакции

Что вы построите: цель туториала

В этом руководстве мы создадим простое консольное приложение на Node.js, которое автоматически проверяет платёжные данные (IBAN, SWIFT, ИНН) перед отправкой в вашу систему. Мы настроим валидацию в реальном времени, обработку ошибок и уведомления через Webhooks.

К концу урока у вас будет рабочий скрипт, который возвращает статус транзакции и рекомендации по комплаенсу за <80 мс.

Подготовка

Предварительные требования

Node.js

Установите Node.js версии 14 или выше. Мы будем использовать стандартный модуль fetch (доступен с Node 18) или библиотеку axios.

API Ключ

Учётная запись на Regexly. Если её нет, зарегистрируйтесь на regexly.io — тариф Free включает 1000 запросов в месяц.

Терминал

Базовые навыки работы с командной строкой для установки пакетов и запуска скриптов.

Тестовые данные

Несколько тестовых IBAN или SWIFT кодов для проверки работы скрипта.

Пошаговая инструкция

Интеграция за 4 шага

Шаг 1: Получение API-ключа

Перейдите в панель управления Regexly, раздел Developer → API Keys. Нажмите кнопку Create Key. Скопируйте полученный ключ (начинается с rx_live_).

Сохраните его в переменную окружения REGEXLY_API_KEY для безопасности.

Шаг 2: Первый запрос валидации

Отправьте POST-запрос на эндпоинт /v1/validate. В теле запроса укажите тип данных и само значение.


            curl -X POST https://api.regexly.io/v1/validate \
            -H "Authorization: Bearer YOUR_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"type": "iban", "value": "DE89370400440532013000"}'

Шаг 3: Настройка Webhooks

Чтобы получать уведомления о статусе проверки асинхронно, создайте Webhook. Это особенно важно для сложных транзакций, требующих ручной проверки комплаенса.


            curl -X POST https://api.regexly.io/v1/webhooks \
            -H "Authorization: Bearer YOUR_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"url": "https://your-domain.com/api/webhooks/regexly", "events": ["transaction.completed"]}'

Шаг 4: Обработка ошибок и повторные попытки

При сбоях сервера (5xx) или превышении лимитов (429) Regexly возвращает соответствующий код. Ваш скрипт должен реализовать логику повторных попыток с экспоненциальной задержкой.

Пример: Если получен код 429, подождите время, указанное в заголовке Retry-After, прежде чем делать новый запрос.

Решение

Готовый пример на Node.js

Node.js Production Ready

Смотреть на GitHub

// config.js
// Загрузка ключей из переменных окружения
// process.env.REGEXLY_API_KEY

// validator.js
// Основной модуль валидации
// Включает retry-логику и webhook-уведомления

// server.js
// Express-сервер для приема Webhooks

Дальнейшее развитие

Что дальше?

После базовой интеграции рассмотрите следующие возможности платформы для масштабирования вашего бизнеса.

Пакетная обработка

Используйте эндпоинт /v1/batch для проверки массива транзакций за один вызов. Сэкономьте до 60% времени на обработке больших объёмов данных.

AI Анализ

Включите модуль машинного обучения для выявления аномалий в поведении клиентов. Regexly предложит вероятные риски на основе исторических данных.

Коннекторы

Интегрируйтесь напрямую с SAP, Oracle или 1C через наши готовые коннекторы, чтобы исключить необходимость ручного импорта данных.