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

Материал из TourClient - Руководство пользователя
Перейти к: навигация, поиск
(Запрос к сервису)
Строка 14: Строка 14:
 
<Request>
 
<Request>
 
     <TourSearchRequest>
 
     <TourSearchRequest>
         <dataOffset>0</dataOffset>
+
         <dataOffset>0</dataOffset>  <!-- Смещение блока запрашиваемого данных, относительно всех найденных результатов.  -->
         <dataLimit>50</dataLimit>
+
         <dataLimit>50</dataLimit>  <!-- Размер блока данных. -->
   
+
        <!-- Суммарно эти параметры опеределяют запрошенную страницу  -->
         <seatStatus>3</seatStatus>
+
 
   
+
         <seatStatus>3</seatStatus>  <!--  -->
         <cityId>1000</cityId>
+
 
         <countryId>12</countryId>
+
         <cityId>1000</cityId>      <!-- Идентификатор города вылета. -->
         <roomSizeId>14</roomSizeId>
+
         <countryId>12</countryId>  <!-- Идентификатор страны прилета. -->
   
+
         <roomSizeId>14</roomSizeId> <!-- Идентификатор размещения (DBL,SNGL,TRL...). -->
         <adults>2</adults>
+
 
         <children>0</children>
+
         <adults>2</adults>          <!-- Количество взрослых. -->
   
+
         <children>0</children>      <!-- Количество детей. -->
         <childAge1>0</childAge1>
+
 
         <childAge2>0</childAge2>
+
         <childAge1>0</childAge1>    <!-- Возраст первого ребенка. -->
   
+
         <childAge2>0</childAge2>    <!-- Возраст второго ребенка. -->
         <durationFrom>7</durationFrom>
+
 
         <durationTill>14</durationTill>
+
         <durationFrom>7</durationFrom>  <!-- Продолжительность (количество ночей в отеле). ОТ. -->
   
+
         <durationTill>14</durationTill> <!-- Продолжительность (количество ночей в отеле). ДО. -->
         <departureFrom>2014-07-25</departureFrom>
+
 
         <departureTill>2014-08-10</departureTill>
+
         <departureFrom>2014-07-25</departureFrom>  <!-- Дата вылета ОТ. -->
   
+
         <departureTill>2014-08-10</departureTill>  <!-- Дата вылета ДО. -->
 +
 
 
         <ticket>1</ticket>
 
         <ticket>1</ticket>
   
+
 
         <priceFrom>500</priceFrom>
+
         <priceFrom>500</priceFrom>    
 
         <priceTill>50000</priceTill>
 
         <priceTill>50000</priceTill>
 
         <currency>3</currency>
 
         <currency>3</currency>
   
+
 
 
         <operatorIds>
 
         <operatorIds>
 
             <id>111</id>
 
             <id>111</id>
Строка 46: Строка 47:
 
             <id>333</id>
 
             <id>333</id>
 
         </operatorIds>
 
         </operatorIds>
   
+
 
 
         <resortIds>
 
         <resortIds>
 
             <id>111</id>
 
             <id>111</id>
Строка 52: Строка 53:
 
             <id>333</id>
 
             <id>333</id>
 
         </resortIds>
 
         </resortIds>
   
+
 
 
         <resortPlaceIds>
 
         <resortPlaceIds>
 
             <id>111</id>
 
             <id>111</id>
Строка 58: Строка 59:
 
             <id>333</id>
 
             <id>333</id>
 
         </resortPlaceIds>
 
         </resortPlaceIds>
   
+
 
 
         <allocCatId>7</allocCatId>
 
         <allocCatId>7</allocCatId>
 
         <allocRate>3.56</allocRate>
 
         <allocRate>3.56</allocRate>
   
+
 
 
         <allocationIds>
 
         <allocationIds>
 
             <id>111</id>
 
             <id>111</id>
Строка 67: Строка 68:
 
             <id>333</id>
 
             <id>333</id>
 
         </allocationIds>
 
         </allocationIds>
   
+
 
 
         <mealIds>
 
         <mealIds>
 
             <id>111</id>
 
             <id>111</id>
Строка 73: Строка 74:
 
             <id>333</id>
 
             <id>333</id>
 
         </mealIds>
 
         </mealIds>
   
+
 
 
         <roomViewIds>
 
         <roomViewIds>
 
             <id>111</id>
 
             <id>111</id>
Строка 79: Строка 80:
 
             <id>333</id>
 
             <id>333</id>
 
         </roomViewIds>
 
         </roomViewIds>
   
+
 
 
         <roomTypeIds>
 
         <roomTypeIds>
 
             <id>111</id>
 
             <id>111</id>
Строка 85: Строка 86:
 
             <id>333</id>
 
             <id>333</id>
 
         </roomTypeIds>
 
         </roomTypeIds>
   
+
 
 
     </TourSearchRequest>
 
     </TourSearchRequest>
 
     <TourExtraEntities>
 
     <TourExtraEntities>
Строка 105: Строка 106:
  
 
</source>
 
</source>
 
  
 
=== Ответ сервиса ===
 
=== Ответ сервиса ===

Версия 18:39, 8 июля 2014

Работа с сервисом осуществляется путем отправки POST запросов на адрес http://tourclient.ru/f/exml/user_id/tours_export .

Где user_id - ID пользователя AgentPassport.

POST-параметр request должен содержать xml запроса.

В результате сервис вернет ответ в формате xml.

Запрос к сервису

<?xml version="1.0" encoding="UTF-8"?>
<Request>
    <TourSearchRequest>
        <dataOffset>0</dataOffset>  <!-- Смещение блока запрашиваемого данных, относительно всех найденных результатов.  -->
        <dataLimit>50</dataLimit>   <!-- Размер блока данных. -->
        <!-- Суммарно эти параметры опеределяют запрошенную страницу  -->
 
        <seatStatus>3</seatStatus>  <!--  -->
 
        <cityId>1000</cityId>       <!-- Идентификатор города вылета. -->
        <countryId>12</countryId>   <!-- Идентификатор страны прилета. -->
        <roomSizeId>14</roomSizeId> <!-- Идентификатор размещения (DBL,SNGL,TRL...). -->
 
        <adults>2</adults>          <!-- Количество взрослых. -->
        <children>0</children>      <!-- Количество детей. -->
 
        <childAge1>0</childAge1>    <!-- Возраст первого ребенка. -->
        <childAge2>0</childAge2>    <!-- Возраст второго ребенка. -->
 
        <durationFrom>7</durationFrom>  <!-- Продолжительность (количество ночей в отеле). ОТ. -->
        <durationTill>14</durationTill> <!-- Продолжительность (количество ночей в отеле). ДО. -->
 
        <departureFrom>2014-07-25</departureFrom>  <!-- Дата вылета ОТ. -->
        <departureTill>2014-08-10</departureTill>  <!-- Дата вылета ДО. -->
 
        <ticket>1</ticket>
 
        <priceFrom>500</priceFrom>      
        <priceTill>50000</priceTill>
        <currency>3</currency>
 
        <operatorIds>
            <id>111</id>
            <id>222</id>
            <id>333</id>
        </operatorIds>
 
        <resortIds>
            <id>111</id>
            <id>222</id>
            <id>333</id>
        </resortIds>
 
        <resortPlaceIds>
            <id>111</id>
            <id>222</id>
            <id>333</id>
        </resortPlaceIds>
 
        <allocCatId>7</allocCatId>
        <allocRate>3.56</allocRate>
 
        <allocationIds>
            <id>111</id>
            <id>222</id>
            <id>333</id>
        </allocationIds>
 
        <mealIds>
            <id>111</id>
            <id>222</id>
            <id>333</id>
        </mealIds>
 
        <roomViewIds>
            <id>111</id>
            <id>222</id>
            <id>333</id>
        </roomViewIds>
 
        <roomTypeIds>
            <id>111</id>
            <id>222</id>
            <id>333</id>
        </roomTypeIds>
 
    </TourSearchRequest>
    <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>
    </TourExtraEntities>
</Request>

Ответ сервиса

Сервис возвращает ответ, содержащий массив объектов Тур (Tours) и объект Статус поиска (SearchStatus)

<?xml version="1.0" encoding="UTF-8"?>
<Result>
    <Tours>
        <Tour>...</Tour>
        <Tour>...</Tour>
        <Tour>...</Tour>
        ...
    </Tours>
    <SearchStatus>
       ...
    </SearchStatus>
</Result>

Подробное описание возвращаемых данных можно посмотреть в Описании объектов.


В случае ошибки сервис вернет:

<?xml version="1.0" encoding="UTF-8"?>
<Result>
    <Error>Текст ошибки</Error>
</Result>