Экспертный материал 4Sides
API-интеграция без сюрпризов
Большинство интеграционных проблем возникает не из-за протокола, а из-за разных значений полей, статусов и бизнес-правил. Поэтому проект начинают с общего языка данных и сценариев отказа.
Как подготовить карту данных, обработку ошибок и приёмочные тесты до запуска логистической интеграции.
Карта данных
Для каждого поля определяются источник, формат, обязательность и назначение. Отдельно сопоставляются справочники городов, подразделений, услуг и статусов.
Проверьте перед запуском
- описать владельца каждого поля
- согласовать форматы идентификаторов
- зафиксировать правила обновления справочников
Ошибки и повторы
Система должна отличать временную ошибку от окончательного отказа и безопасно повторять запрос. Идемпотентность защищает от создания дублей при повторной отправке.
Проверьте перед запуском
- единые коды и понятные тексты ошибок
- ограниченная стратегия повторов
- уникальный ключ операции
Приёмочное тестирование
Проверяются не только успешные заявки, но и отмена, изменение данных, недоступность сервиса, повторная отправка и поздний статус. Результаты фиксируются до открытия продуктивного обмена.
Проверьте перед запуском
- набор позитивных и негативных сценариев
- сверка данных в обеих системах
- критерии допуска к промышленному запуску