Как получить API-ключи
Для наших партнёров доступны два типа API-интеграции: Affiliate и B2B. Чтобы узнать подробности, получить техническую спецификацию и API-ключи, обратитесь к аккаунт-менеджеру. В запросе, пожалуйста, сразу укажите адрес сайта, на котором будет размещён продукт, и опишите его параметры: аудиторию, порядок бронирования и другую информацию.
Получить боевой ключ можно только после завершения интеграции с использованием тестового ключа и прохождения сертификации.
В целях безопасности API-ключи нельзя пересылать по электронной почте. Когда аккаунт-менеджер сообщит вам об успешном выпуске sandbox key (тестового ключа), в «Личном кабинете» появится вкладка API.
Кликните на блок с названием компании в правом верхнем углу.
Нажмите «Настройки» в открывшемся окне.
Найдите вкладку «Настройки контракта» и выберите раздел API. Там вы увидите все выданные для вашего контракта ключи и сможете их скопировать.
Чтобы получить боевой ключ отправьте запрос на [email protected]. В письме укажите адрес сайта с завершённой интеграцией или предоставьте доступ к тестовой среде. После вы получите ссылку для прохождения сертификации.
Информация по API-ключам
Метод авторизации API — HTTP Basic Authentication (Basic Auth). Данные запросов всегда передаются в формате json.
Каждый указанный во вкладке «Настройки контракта» ключ содержит параметры:
ID ключа — логин;
токен API-ключа — пароль;
Endpoint URL — адреса для запросов основных методов;
лимит запросов — каждый ключ имеет ограничения по количеству запросов.
Увеличение лимита запросов возможно при обоснованной необходимости и зависит от количества совершенных бронирований.
Ключ может быть:
тестовым — sandbox;
боевым — production.
Тестовым API-ключом можно бронировать только тестовый отель (test_hotel, test_hotel_do_not_book). Все тестовые бронирования необходимо отменять самостоятельно.
Как забронировать тестовый отель:
Как отменить тестовое бронирование
Перейдите по ссылке на отмену в письме с подтверждением бронирования или в «Личном кабинете» ZenHotels. Если отменить бронирование не получается, пожалуйста, свяжитесь с аккаунт-менеджером или службой поддержки по почте [email protected], указав номер заказа.
Не используйте в качестве контактов клиента:
почту, привязанную к RateHawk или аффилиатному кабинету;
некорректные данные, например, набор букв вместо имени или номер телефона типа 11111111111.
Такие бронирования система отметит как мошеннические, а ваша почта попадёт в чёрный список.
Куда обращаться в случае проблем с API
Если у вас возникли вопросы технического характера по API, отправьте запрос на [email protected], приложив:
пример запроса;
ссылку на конкретный используемый метод;
ID используемого ключа (если требуется или если вы используете больше одного);
подробное описание ошибки.
В теме письма укажите номер договора и/или название компании. Формат логов — JSON.
При общении с поддержкой, пожалуйста, сохраняйте историю переписки и всех её участников и не меняйте тему письма. Для этого при ответе всегда пользуйтесь кнопкой «Ответить всем».
Адрес [email protected] предназначен только для технической поддержки, с вопросами по условиям работы поможет разобраться аккаунт-менеджер.