XML - результаты поиска/Информация о туре/Интерфейс — различия между версиями

Материал из TourClient - Руководство пользователя
Перейти к: навигация, поиск
(→‎Запрос к сервису)
 
(не показаны 8 промежуточные версии 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>

Внимание! Атрибут с кодом ошибки может отсутствовать!

Источник — «https://wiki.tourclient.ru/w/index.php?title=XML_-_результаты_поиска/Информация_о_туре/Интерфейс&oldid=3304»