Изменение API PricingService #15
Description
Breaking Change в REST API метода Calculate Price сервиса Pricing Service
Текущая реализация
Текущий REST API метода Calculate Price принимает JSON с параметрами расчета стоимости страхового полиса, включая код продукта, период действия полиса, выбранные покрытия и ответы на вопросы андеррайтинга.
В ответ система возвращает общую стоимость полиса и разбивку по покрытиям.
Предлагаемый Breaking Change
Для улучшения функциональности и прозрачности расчетов предлагается изменить формат запроса и ответа API:
1. Расширение запроса
В тело запроса добавляются дополнительные поля:
- Информация о клиенте (возраст, регион, статус VIP, стаж клиента)
- Контекст запроса (канал продаж, идентификатор сессии, маркетинговая кампания)
- Флаг детализации расчета
- Код валюты расчета
2. Расширение ответа
Ответ будет содержать не только финальную стоимость, но и:
- Детализацию расчета по каждому покрытию с указанием базовой цены и примененных коэффициентов
- Предупреждения и сообщения о процессе расчета
- Уникальный идентификатор расчета для отслеживания
- Временные метки создания и истечения срока действия расчета
3. Изменение структуры URL
Для поддержки версионирования API эндпоинт будет изменен с /calculate-price на /v2/calculate-price.
Бизнес-ценность изменений
Для клиентского опыта:
- Прозрачность расчета позволяет лучше понимать, за что взяли деньги
- Персонализация цен дает более точные предложения для разных категорий клиентов
- Детальная информация помогает агентам объяснять стоимость полиса
Для внутренних процессов:
- Улучшенная аналитика факторов ценообразования
- Возможность тестировать различные ценовые стратегии
- Лучший контроль качества алгоритмов расчета цен
- Аудит всех расчетов через уникальные идентификаторы
Для партнеров и интеграторов:
- Богатые данные для интеграции в собственные системы
- Гибкость в выборе уровня детализации ответов
- Поддержка различных валют
Последствия Breaking Change
Для внешних потребителей API:
- Необходимо обновить интеграционные решения до новой версии API
- Старая версия API будет работать параллельно в течение переходного периода
- После окончания переходного периода старая версия будет отключена
Для внутренней инфраструктуры:
- Увеличение нагрузки на сервис из-за расширенных ответов
- Необходимость расширения логирования и мониторинга
- Обновление документации и OpenAPI спецификаций
План миграции
- Реализовать новую версию API параллельно с текущей
- Обновить внутренние потребители API (Policy Service)
- Уведомить внешних партнеров о предстоящих изменениях
- Предоставить песочницу с новой версией API
- После завершения перехода внешних потребителей отключить старую версию
Заключение
Этот breaking change значительно повысит прозрачность и гибкость системы ценообразования, обеспечит лучший клиентский опыт и даст мощную аналитическую базу для оптимизации ценовой стратегии компании.