Поток интеграции и версии
Поток демонстрационного Affiliate API связывает справочники, контент и динамические предложения. Следуйте ему последовательно, чтобы показывать пользователю согласованные данные.
От географии до выбранного предложения
- Geo: определите направление и сохраните его идентификатор.
- Content: подготовьте описания, фотографии и правила объектов.
- Search: запросите предложения на даты и состав гостей.
- Hotel Page: уточните выбранный оффер перед дальнейшим действием.
После каждого шага отдельно обрабатывайте ошибку транспорта, ошибку API и корректный пустой результат. Не подменяйте сбой ответом «ничего не найдено».
Что показать гостю
- Полную цену и валюту на выбранный состав гостей.
- Условия и сроки отмены.
- Правила объекта и дополнительные платежи.
- Тип подтверждения предложения.
Версии и изменения
В демонстрационном сценарии версия API задаётся в URL: /api/v2/.... Версия API, версия OpenAPI-контракта и версия сайта документации — разные сущности.
| Изменение | Действие интегратора |
|---|---|
| Новое необязательное поле | Проверьте устойчивость клиента к расширению ответа |
| Изменение обязательного поля | Согласуйте миграцию и совместимость |
| Новая версия API | Пройдите тестовые сценарии до переключения |
Поддержка
Приложите к обращению время и request ID, название операции и обезличенный пример ответа. Секреты и персональные данные удалите.
Откройте справочник Dictionary, чтобы сравнить представление реальных контрактов.