Поток интеграции и версии

Поток демонстрационного Affiliate API связывает справочники, контент и динамические предложения. Следуйте ему последовательно, чтобы показывать пользователю согласованные данные.

От географии до выбранного предложения

1. Geo: определите направление и сохраните его идентификатор.
2. Content: подготовьте описания, фотографии и правила объектов.
3. Search: запросите предложения на даты и состав гостей.
4. Hotel Page: уточните выбранный оффер перед дальнейшим действием.

После каждого шага отдельно обрабатывайте ошибку транспорта, ошибку API и корректный пустой результат. Не подменяйте сбой ответом «ничего не найдено».

Что показать гостю

• Полную цену и валюту на выбранный состав гостей.
• Условия и сроки отмены.
• Правила объекта и дополнительные платежи.
• Тип подтверждения предложения.

Версии и изменения

В демонстрационном сценарии версия API задаётся в URL: /api/v2/.... Версия API, версия OpenAPI-контракта и версия сайта документации — разные сущности.

Изменение	Действие интегратора
Новое необязательное поле	Проверьте устойчивость клиента к расширению ответа
Изменение обязательного поля	Согласуйте миграцию и совместимость
Новая версия API	Пройдите тестовые сценарии до переключения

Поддержка

Приложите к обращению время и request ID, название операции и обезличенный пример ответа. Секреты и персональные данные удалите.

Откройте справочник Dictionary, чтобы сравнить представление реальных контрактов.