Изменение API PricingService

[oveeernight]

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:

1. Необходимо обновить интеграционные решения до новой версии API
2. Старая версия API будет работать параллельно в течение переходного периода
3. После окончания переходного периода старая версия будет отключена

Для внутренней инфраструктуры:

1. Увеличение нагрузки на сервис из-за расширенных ответов
2. Необходимость расширения логирования и мониторинга
3. Обновление документации и OpenAPI спецификаций

План миграции

1. Реализовать новую версию API параллельно с текущей
2. Обновить внутренние потребители API (Policy Service)
3. Уведомить внешних партнеров о предстоящих изменениях
4. Предоставить песочницу с новой версией API
5. После завершения перехода внешних потребителей отключить старую версию

Заключение

Этот breaking change значительно повысит прозрачность и гибкость системы ценообразования, обеспечит лучший клиентский опыт и даст мощную аналитическую базу для оптимизации ценовой стратегии компании.