Запрос выполнился дважды
Что разберём
Проверяем идемпотентность операции.
Врост24 / Работающая система
Нестандартные интеграции и API
Нестандартный обмен — с контролем ошибок и повторов.
Спроектируем интеграцию через API для задачи, которую не покрывает готовый коннектор. Опишем данные, события, авторизацию и правила восстановления после ошибки.
Топ-3 Южного УралаЗолотой партнёр Битрикс24Битрикс24 + ИИ Внедрение и развитие
КОНТРОЛИРУЕМЫЙ ОБМЕНДАННЫЕ + ПРАВИЛА
ИсточникAPI систем
Идентификатор · поля · событие
ПолучательСобытия и данные
ПереданоПровереноОшибка видна
Повторная передача должна обновлять нужную запись, а не создавать случайный дубль.
Узнать свою ситуацию
Проблема должна быть видна до начала работ.
Сервис временно недоступен
Что разберём
Определяем повтор и предел ожидания.
Изменился формат ответа
Что разберём
Фиксируем контракт и контроль совместимости.
Состав работ
Что именно разберём и сделаем.
Контракт
Фиксируем формат запросов и ответов, обязательные поля и идентификаторы.
Авторизация
Выбираем поддерживаемый способ и минимальные необходимые права.
События
Определяем запуск по событию или расписанию.
Ограничения
Учитываем лимиты API, объём и задержки.
Повторы
Предотвращаем дубли при повторном запросе.
Наблюдаемость
Добавляем журнал и информацию для разбора ошибок.
После завершения
У вас остаётся понятный результат.
Результат можно использовать в работе и проверить на конкретных примерах. Состав материалов согласуем до старта.
- Карта данныхСодержание и границы зафиксированы.
- Рабочее подключениеПонятны правила и следующие действия.
- Сценарии сверкиЕсть критерии проверки и ответственный.
СТРУКТУРА РЕЗУЛЬТАТАРабочий документ
Источник и получатель
Для каждой сущности указаны ведущая система и направление передачи.
Поля и идентификаторы
Описаны ключи сопоставления, обязательные значения и обновления.
Ошибка и повтор
Зафиксированы журнал, повторная обработка и ответственный за сбой.
Пример состава материала. Наполнение — по вашей задаче.
Порядок работы
Движемся по этапам. Проверяем каждый.
Описываем данные
Согласуем объекты, поля и ведущие источники.
Результат этапаКарта обмена
Настраиваем подключение
Реализуем передачу и обработку исключений.
Результат этапаТестовый обмен
Сверяем результат
Проверяем создание, изменение, повтор и ошибку.
Результат этапаПротокол сверки
Запускаем
Фиксируем переключение, контроль и поддержку.
Результат этапаРабочий порядок
Приёмка без догадок
Как убедиться, что задача решена.
СценарийКак выглядит корректный результат
Новая запись
Данные появляются в согласованной системе и связаны с источником.
Изменение или повтор
Обновляется нужная запись без непредусмотренного дубля.
Ошибка передачи
Понятны причина, ответственный и порядок повторной обработки.
Критерии уточняем до выполнения работ. Замечания фиксируем отдельно от новых пожеланий.
Совместная работа
Заранее понятно, что нужно от каждого.
С нашей стороны
Организовать работу и показать результат.
- Разобрать задачу и обозначить ограничения.
- Согласовать состав работ и способ проверки.
- Зафиксировать решения и передать материалы.
Со стороны компании
Дать контекст и проверить сценарий.
- API систем.
- События и данные.
- Ограничения доступа.
- Ответственный сотрудник для уточнений и приёмки.
Оценка проекта
Стоимость зависит от задачи и её границ.
До начала работ согласуем объём, этапы и результат. Отдельно покажем необходимые лицензии, внешние сервисы и инфраструктуру.
Границы задачи
Количество процессов, ролей и систем, которые нужно разобрать.
Исходное состояние
Качество данных, существующие настройки и доступность примеров.
Способ реализации
Штатные инструменты, интеграции или отдельная разработка.
Практика Врост24
Посмотрите, как мы разбираем рабочие задачи.
До начала работ
Что обычно важно уточнить.
Подойдёт ли готовый коннектор?
Проверяем его по составу данных, ограничениям, тарифу и условиям поддержки.
Какие доступы нужны?
Только согласованные доступы к участвующим системам; объём определяем до работ.
Что влияет на стоимость?
Количество сущностей, нестандартные правила, качество исходных данных и ограничения систем.
Кто отвечает за ошибки после запуска?
Фиксируем владельца интеграции, журнал и порядок обращения в поддержку.
Начнём с вашей работы
Начнём с вашей задачи.
Разберём процесс и предложим первый этап: настройку, интеграцию, аудит или ИИ-сценарий.