XML - результаты поиска/Информация о туре/Интерфейс — различия между версиями
Материал из TourClient - Руководство пользователя
м (Artemandreev переименовал страницу XML экспорт/Информация о туре/Интерфейс в XML - результаты поиска/Информация о туре/Интерфейс) |
Levenets (обсуждение | вклад) |
||
(не показаны 6 промежуточные версии 3 участников) | |||
Строка 18: | Строка 18: | ||
<TourRequest> | <TourRequest> | ||
<id>ID_ТУРА</id> <!-- <id>16030704796@511</id> --> | <id>ID_ТУРА</id> <!-- <id>16030704796@511</id> --> | ||
+ | <shortId>Короткий ID тура</shortId> <!-- [Опционально, вместо длинного ID тура] <shortId>709802</shortId> --> | ||
+ | <currency>3</currency> <!-- [Опционально] Валюта, в которой необходимо вернуть цены (валюта запроса). --> | ||
+ | <!-- 1 - USD, 2 - EUR, 3 - RUB, 4 - UAH, 5 - BYN, 6 - KZT --> | ||
</TourRequest> | </TourRequest> | ||
<TourExtraEntities> <!-- [Опционально] Дополнительные объекты которые нужно добавить к объекту тур. Возможные значения перечислены в ниже. --> | <TourExtraEntities> <!-- [Опционально] Дополнительные объекты которые нужно добавить к объекту тур. Возможные значения перечислены в ниже. --> | ||
Строка 33: | Строка 36: | ||
<entity>RoomView</entity> | <entity>RoomView</entity> | ||
<entity>Operator</entity> | <entity>Operator</entity> | ||
+ | <entity>ShortId</entity> <!-- короткий id тура --> | ||
+ | <entity>OfferFlags</entity> <!-- Флаги тура (promoPrice, ComboTour, hasProgram) --> | ||
</TourExtraEntities> | </TourExtraEntities> | ||
</Request> | </Request> |
Текущая версия на 10:28, 25 февраля 2021
Работа с сервисом осуществляется путем отправки POST запросов на адрес http://tourclient.ru/f/exml/user_id/tours_export .
Где user_id - ID пользователя AgentPassport.
POST-параметр request должен содержать xml запроса.
В результате сервис вернет ответ в формате xml.
Запрос к сервису
- Для получения информации о туре необходимо указать id тура.
<?xml version="1.0" encoding="UTF-8"?> <Request> <TourRequest> <id>ID_ТУРА</id> <!-- <id>16030704796@511</id> --> <shortId>Короткий ID тура</shortId> <!-- [Опционально, вместо длинного ID тура] <shortId>709802</shortId> --> <currency>3</currency> <!-- [Опционально] Валюта, в которой необходимо вернуть цены (валюта запроса). --> <!-- 1 - USD, 2 - EUR, 3 - RUB, 4 - UAH, 5 - BYN, 6 - KZT --> </TourRequest> <TourExtraEntities> <!-- [Опционально] Дополнительные объекты которые нужно добавить к объекту тур. Возможные значения перечислены в ниже. --> <entity>OnlineSeatsState</entity> <entity>ExtraCharges</entity> <entity>City</entity> <entity>Country</entity> <entity>RoomSize</entity> <entity>Resort</entity> <entity>ResortPlace</entity> <entity>Allocation</entity> <entity>AllocCat</entity> <entity>Meal</entity> <entity>RoomType</entity> <entity>RoomView</entity> <entity>Operator</entity> <entity>ShortId</entity> <!-- короткий id тура --> <entity>OfferFlags</entity> <!-- Флаги тура (promoPrice, ComboTour, hasProgram) --> </TourExtraEntities> </Request>
Ответ сервиса
Сервис возвращает ответ, содержащий объект Тур (Tour)
<?xml version="1.0" encoding="UTF-8"?> <Result> <Tour>...</Tour> </Result>
Подробное описание возвращаемых данных можно посмотреть в Описании объектов.
В случае ошибки сервис вернет:
<?xml version="1.0" encoding="UTF-8"?> <Result> <Error code="код ошибки">Текст ошибки</Error> </Result>
Внимание! Атрибут с кодом ошибки может отсутствовать!