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

Материал из TourClient - Руководство пользователя
Перейти к: навигация, поиск
м (→‎Ответ сервиса)
(→‎Запрос к сервису)
Строка 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>          <!-- [Опционально] Валюта, в которой необходимо вернуть цены (валюта запроса). -->
 
         <currency>3</currency>          <!-- [Опционально] Валюта, в которой необходимо вернуть цены (валюта запроса). -->
 
                                         <!-- 1 - USD, 2 - EUR, 3 - RUB, 4 - UAH -->
 
                                         <!-- 1 - USD, 2 - EUR, 3 - RUB, 4 - UAH -->

Версия 17:15, 12 сентября 2016

Работа с сервисом осуществляется путем отправки 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 -->
    </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 тура -->
    </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=3064»