XML - результаты поиска/Поиск туров/Интерфейс - Результаты поиска — различия между версиями
Материал из TourClient - Руководство пользователя
Jeka (обсуждение | вклад) м (Jeka переименовал страницу XML экспорт/Поиск туров/Сервис - Результаты поиска в XML экспорт/Поиск туров/Интерфейс - Результаты поиска без …) |
Jeka (обсуждение | вклад) (→Запрос к сервису) |
||
Строка 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>