Фрагментация знаний
Каждая из 42 интеграций имела свой формат данных. Разработчики тратили до 30% времени на чтение чужого кода, чтобы понять структуру входящего JSON.
Кейс: FinTech
Как PaySwift ускорил разработку API на 40%
История о том, как финтех-стартап из 50 человек отказался от ручного написания валидации и перешел на визуальные схемы данных, сэкономив сотни часов разработки.
01. О клиенте
PaySwift: Скорость против Бюрократии
PaySwift — это платежный шлюз нового поколения, работающий с микро-транзакциями для SaaS-сервисов. Их главная ценность — надежность и мгновенная обработка запросов.
В 2023 году компания пережила бурный рост. Количество интеграций с банками и эквайрингами выросло с 5 до 42. Инженерная команда столкнулась с классической проблемой масштабируемости: документация отставала от кода, а спецификации API в Confluence превратились в «кладбище правды».
Когда вы меняете одно поле в объекте транзакции, это должно мгновенно отразиться валидации на бэкенде, интерфейсах фронтенда и документации для клиентов. До внедрения JsonForge этот процесс занимал у команды 3-5 дней.
Было:
- ✕ Ручное написание JSON-схем
- ✕ Дублирование типов в TS и Java
- ✕ Ошибки валидации на продакшене
02. Проблема
Ад валидации и «Синдром размытых скобок»
Основная боль PaySwift заключалась не в логике обработки платежей, а в согласовании структур данных. Их API обрабатывал более 10 миллионов запросов в день, каждый из которых должен был строго соответствовать спецификациям банков-партнеров.
Медленные циклы
Изменение формата ответа от одного банка требовало правок в 3 репозиториях (Backend, Frontend, Mobile). Время выхода фичи (Time-to-Market) составляло 2 недели.
03. Решение
Интеграция JsonForge в CI/CD
PaySwift выбрал JsonForge не просто как редактор, а как «истину в последней инстанции» (Source of Truth) для своих данных.
Архитектура внедрения:
- 01. Визуальное моделирование: Архитекторы PaySwift создали единую библиотеку типов транзакций в визуальном редакторе JsonForge.
- 02. Генерация кода: При каждом коммите схемы в Git, плагин JsonForge автоматически генерировал TypeScript-интерфейсы и Java-классы.
- 03. Автоматическая валидация: Middleware на Go теперь компилировался на основе схем JsonForge, отсекая невалидные запросы до попадания в бизнес-логику.
Схема транзакции PaySwift
04. Результаты
Метрики за первые 3 месяца
40%
Рост скорости разработки
0
Ошибок типов (TS/Java)
2.5x
Ускорение онбординга
100%
Актуальная документация
«JsonForge превратил наши бесконечные споры о валидации данных в автоматический процесс. Теперь мы спорим только о бизнес-логике, а не о том, где пропустили запятую.»
Алексей Громов
CTO, PaySwift