Обзор API v2.0
Архитектура ликвидности нового поколения. RESTful интерфейс для управления балансами, маршрутизации платежей и аналитики в реальном времени.
Authorization: Bearer eyJhbG...
Content-Type: application/json
{
"amount": 150000,
"currency": "RUB",
"routing_strategy": "FASTEST"
}
Аутентификация
Все запросы к J-SOnly API должны быть аутентифицированы. Мы используем стандартный подход Bearer-токенов для обеспечения безопасности сессий и интеграций.
API Ключи
Генерируйте уникальные пары ключей (Public/Private) в личном кабинете. Ключи имеют привязку к IP-адресам серверов вашей инфраструктуры.
OAuth 2.0
Для интеграций с ERP-системами (1С, SAP) доступен полноценный OAuth 2.0 flow с поддержкой refresh-токенов и автоматического обновления сессии.
Webhooks подписи
Входящие уведомления подписываются вашим приватным ключом. Проверяйте заголовок X-JS-Signature для валидации целостности данных.
Обработка ошибок
Мы придерживаемся стандартов HTTP для кодов состояния. В случае ошибки тело ответа всегда содержит JSON с расширенным описанием.
"error": {
"code": "INSUFFICIENT_FUNDS",
"message": "Баланс счета 40802... меньше суммы перевода",
"request_id": "req_839201jsd92",
"details": {
"available": 12500.00,
"required": 15000.00
}
}
}
Используйте request_id при обращении в техническую поддержку для быстрого поиска логов транзакции.
Версионирование
Мы гарантируем обратную совместимость в рамках одной мажорной версии. Текущая стабильная версия — v2.0.
URL Версионирование
Версия API жестко зашита в URL эндпоинта (например, api.js-only.com/v2/). Это позволяет нам запускать новые версии параллельно со старыми.
Политика Deprecation
Мы предупреждаем о выводе из эксплуатации (Deprecation) за 6 месяцев. Заголовки ответов будут содержать Sunset дату.
Лимиты запросов (Rate Limiting)
Защита инфраструктуры и стабильность сервиса обеспечиваются динамическим ограничением частоты запросов (RPM).
Заголовки лимитов
В каждом ответе вы получаете текущий статус: X-RateLimit-Limit (максимум), X-RateLimit-Remaining (остаток) и X-RateLimit-Reset (время сброса в Unix-time).
Экспоненциальная задержка
Рекомендуем реализовывать алгоритм "Exponential Backoff" при получении ошибки 429, чтобы не перегружать наш шлюз при восстановлении.
Повышение лимитов
Для высоконагруженных проектов (High-Frequency Trading, массовые выплаты) лимиты настраиваются индивидуально в рамках Enterprise контракта.
Начните разработку прямо сейчас
Получите тестовый API-ключ и доступ к песочнице (Sandbox) за 30 секунд. Без привязки карты.