Агентский API Отели: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(→‎Запрос)
(→‎Ответ)
Строка 317: Строка 317:
  
 
==== Ответ ====
 
==== Ответ ====
−
<pre>
+
<pre><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
−
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
 
       <ns1:hotelsResponse>
 
       <ns1:hotelsResponse>
Строка 389: Строка 388:
 
</SOAP-ENV:Envelope>
 
</SOAP-ENV:Envelope>
 
</pre>
 
</pre>
 +
 +
Элемент Hotel
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
| style="width:208px" |
 +
Элемент
 +
 +
| style="width:208px" |
 +
Описание
 +
 +
| style="width:208px" |
 +
Допустимые значения
 +
 +
|-
 +
| style="width:208px" |
 +
Атрибут Id
 +
 +
| style="width:208px" |
 +
Обязательный. Идентификатор отеля в системе Nemo.
 +
 +
| style="width:208px" |
 +
Целое число.
 +
 +
|-
 +
| style="width:208px" |
 +
CityId
 +
 +
| style="width:208px" |
 +
Обязательный. Идентификатор города.
 +
 +
| style="width:208px" |
 +
Целое число.
 +
 +
|-
 +
| style="width:208px" |
 +
CountryId
 +
 +
| style="width:208px" |
 +
Обязательный. Идентификатор страны .
 +
 +
| style="width:208px" |
 +
Целое число.
 +
 +
|-
 +
| style="width:208px" |
 +
Latitude
 +
 +
| style="width:208px" |
 +
Необязательный. Широта.
 +
 +
| style="width:208px" |
 +
Вещественное число.
 +
 +
|-
 +
| style="width:208px" |
 +
Longitude
 +
 +
| style="width:208px" |
 +
Необязательный. Долгота.
 +
 +
| style="width:208px" |
 +
Вещественное число.
 +
 +
|-
 +
| style="width:208px" |
 +
Rating
 +
 +
| style="width:208px" |
 +
Необязательный. Рейтинг.
 +
 +
| style="width:208px" |
 +
Вещественное число.
 +
 +
|-
 +
| style="width:208px" |
 +
Floors
 +
 +
| style="width:208px" |
 +
Необязательный. Количество этажей
 +
 +
| style="width:208px" |
 +
Целое число.
 +
 +
|-
 +
| style="width:208px" |
 +
Data
 +
 +
| style="width:208px" |
 +
Необязательный.
 +
 +
| style="width:208px" |
 +
Набор элементов Info.
 +
 +
|-
 +
| style="width:208px" |
 +
Phones
 +
 +
| style="width:208px" |
 +
Необязательный. Массив телефонов.
 +
 +
| style="width:208px" |
 +
Набор элементов Phone.
 +
 +
|-
 +
| style="width:208px" |
 +
Fax
 +
 +
| style="width:208px" |
 +
Необязательный. Факс.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|-
 +
| style="width:208px" |
 +
Images
 +
 +
| style="width:208px" |
 +
Необязательный. Маcсив изображений.
 +
 +
| style="width:208px" |
 +
Набор элементов Image.
 +
 +
|}
 +
 +
Элемент Info.
 +
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
| style="width:208px" |
 +
Элемент
 +
 +
| style="width:208px" |
 +
Описание
 +
 +
| style="width:208px" |
 +
Допустимые значения
 +
 +
|-
 +
| style="width:208px" |
 +
Name
 +
 +
| style="width:208px" |
 +
Обязательный. Наименование отеля.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|-
 +
| style="width:208px" |
 +
Area
 +
 +
| style="width:208px" |
 +
Необязательный. Описание места расположения отеля.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|-
 +
| style="width:208px" |
 +
Location
 +
 +
| style="width:208px" |
 +
Необязательный. Район города.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|-
 +
| style="width:208px" |
 +
Desc
 +
 +
| style="width:208px" |
 +
Необязательный. Описание отеля.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|-
 +
| style="width:208px" |
 +
Address
 +
 +
| style="width:208px" |
 +
Необязательный. Адрес отеля.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|}
 +
 +
Элемент Phones.
 +
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
| style="width:208px" |
 +
Элемент
 +
 +
| style="width:208px" |
 +
Описание
 +
 +
| style="width:208px" |
 +
Допустимые значения
 +
 +
|-
 +
| style="width:208px" |
 +
Phone
 +
 +
| style="width:208px" |
 +
Обязательный. Телефон.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|}
 +
 +
Элемент Image.
 +
 +
{| style="width: 800px" class="wikitable"
 +
|-
 +
| style="width:208px" |
 +
Элемент
 +
 +
| style="width:208px" |
 +
Описание
 +
 +
| style="width:208px" |
 +
Допустимые значения
 +
 +
|-
 +
| style="width:208px" |
 +
Path
 +
 +
| style="width:208px" |
 +
Необязательный. Путь к полному изображению.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|-
 +
| style="width:208px" |
 +
Icon
 +
 +
| style="width:208px" |
 +
Необязательный. Путь к миниатюре, иконке.
 +
 +
| style="width:208px" |
 +
Строка в произвольном формате.
 +
 +
|}
 +
 
==== Ошибки ====
 
==== Ошибки ====

Версия 07:24, 7 октября 2013

Динамические данные

Поиск

Запрос

Ответ

Ошибки

Дополнительная информация по одному отелю

Запрос

Ответ

Ошибки

Штрафы за аннуляцию

Запрос

Ответ

Ошибки

Бронирование

Запрос

Ответ

Ошибки

Выгрузка актуальных данных по заказу(ам)

Запрос

Ответ

Ошибки

Аннуляция заказа

Запрос

Ответ

Ошибки

Статические данные

Для работы с веб-сервисом Nemo необходимо выгрузить статичные данные. Это данные о странах, городах и отелях.

Страна

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CountryStatic

Запрос

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic">
   <soapenv:Header/>
   <soapenv:Body>
      <ver:countries>
         <RequestBin>
            <Request>
               <CountryStatic>
               </CountryStatic>
            </Request>
            <Source>
               <ClientId></ClientId>
               <APIKey></APIKey>
               <Language>ru</Language>
               <Currency>RUB</Currency>
            </Source>
         </RequestBin>
      </ver:countries>
   </soapenv:Body>
</soapenv:Envelope>

Элемент Request

Элемент Описание Допустимые значения
CountryStatic Пустой элемент

Ответ

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body>
      <ns1:countriesResponse>
         <ResponseBin>
            <Response>
               <CountryStatic>
                  <Countries>
                     <Country Id="4">
                        <Code>AF</Code>
                        <Continent>asia</Continent>
                        <Data>
                           <Info Language="RU">
                              <Name>Афганистан</Name>
                           </Info>
                           <Info Language="EN">
                              <Name>Afghanistan</Name>
                           </Info>
                        </Data>
                     </Country>			
                  </Countries>
               </CountryStatic>
            </Response>
         </ResponseBin>
      </ns1:countriesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Элемент CountryStatic

Элемент Описание Допустимые значения
Countries Обязательный Набор элементов Country

Элемент Country

Элемент Описание Допустимые значения
Атрибут Id Обязательный. Идентификатор страны (ISO). Целое число
Code Обязательный. Код страны ISO. Строка из 2-х латинских букв
Continent Обязательный. Название континента. Строка.
Data Обязательный. Информация требующая перевода. Набор элементов Info.

Элемент Info

Элемент Описание Допустимые значения
Атрибут Language Обязательный. Язык в котором представлена информация. Строка из 2-х латинских букв.
Name Обязательный. Наименование страны. Строка в произвольном формате.

Ошибки

Город

Параметры поиска всех услуг требуют указания ID города. Города выгружаются по каждой стране следующим запросом: WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CityStatic

Запрос

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
   <soapenv:Header/>
   <soapenv:Body>
      <ver:cities>
         <RequestBin>
            <Request>
               <CityStatic>
                  <CountryId>4</CountryId>
               </CityStatic>
            </Request>
            <Source>
               <ClientId></ClientId>
               <APIKey></APIKey>
               <Language>ru</Language>
               <Currency>RUB</Currency>
            </Source>
         </RequestBin>
      </ver:cities>
   </soapenv:Body>
</soapenv:Envelope>

Элемент CityStatic

Элемент Описание Допустимые значения
CountryId Обязательный. Идентификатор страны. Целое число

Ответ

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic">
   <SOAP-ENV:Body>
      <ns1:citiesResponse>
         <ResponseBin>
            <Response>
               <CityStatic>
                  <Cities>
<City Id="1">
                        <Name>Кабул</Name>
                        <CountryId>4</CountryId>
                        <Data>
                           <Info Language="EN">
                              <Name>Kabul</Name>
                           </Info>
                           <Info Language="RU">
                              <Name>Кабул</Name>
                           </Info>
                        </Data>
                     </City>
                     <City Id="204793">
                        <Name>Aibak</Name>
                        <CountryId>4</CountryId>
                        <Data>
                           <Info Language="EN">
                              <Name>Aibak</Name>
                           </Info>
                           <Info Language="RU">
                              <Name>Aibak</Name>
                           </Info>
                        </Data>
                     </City>
                     <City Id="204785">
                        <Name>Anar Darah</Name>
                        <CountryId>4</CountryId>
                        <Data>
                           <Info Language="EN">
                              <Name>Anar Darah</Name>
                           </Info>
                           <Info Language="RU">
                              <Name>Anar Darah</Name>
                           </Info>
                        </Data>
                     </City>
			...
     </Cities>
               </CityStatic>
            </Response>
         </ResponseBin>
      </ns1:citiesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Элемент CityStatic

Элемент Описание Допустимые значения
Cities Обязательный. Массив городов. Набор элементов City

Элемент City

Элемент Описание Допустимые значения
Атрибут Id Обязательный. Идентификатор города. Целое число
Name Название города.
Data Названия городов на разных языках. В данный момент поддерживаются названия на русском и английском. См. описание элемента Data в ответе получения информации о стране.

Ошибки

Статика по отелям и апартаментам

Этот запрос будет использоваться для выгрузки статичной информации по одному или нескольким отелям.

WSDL (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelStatic

Запрос

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic">
   <soapenv:Header/>
   <soapenv:Body>
      <ver:hotels>
         <RequestBin>
            <Request>
               <HotelStatic>
                  <CityId>58166</CityId>
               </HotelStatic>
            </Request>
            <Source>
               <ClientId></ClientId>
               <APIKey></APIKey>
               <Language>ru</Language>
               <Currency>RUB</Currency>
            </Source>
         </RequestBin>
      </ver:hotels>
   </soapenv:Body>
</soapenv:Envelope>

Элемент Hotels

Элемент Описание Допустимые значения
CityId Обязательный. Идентификатор города из которого необходимо получить отели. Целое число

Ответ

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body>
      <ns1:hotelsResponse>
         <ResponseBin>
            <Response>
               <HotelStatic>
                  <Hotels>
                     <Hotel Id="271714" Apartment="false">
                        <CityId>58166</CityId>
                        <CountryId>643</CountryId>
                        <Latitude xsi:nil="true"/>
                        <Longitude xsi:nil="true"/>
                        <Rating>3</Rating>
                        <Floors xsi:nil="true"/>
                        <Data>
                           <Info>
                              <Name>* Azimut (business)</Name>
                              <Area xsi:nil="true"/>
                              <Location>Within city</Location>
                              <Desc>This 3 star hotel is located within the city of St Petersburg.</Desc>
                              <Address>43/1 Lermoutovsky Prospect, St Petersburg, 190103</Address>
                           </Info>
                        </Data>
                        <Phones>
                           <Phone>812 7402640</Phone>
                        </Phones>
                        <Fax>812 2518890</Fax>
                        <Images/>
                     </Hotel>
                     <Hotel Id="159535" Apartment="false">
                        <CityId>58166</CityId>
                        <CountryId>643</CountryId>
                        <Latitude>59.935011</Latitude>
                        <Longitude>30.309284</Longitude>
                        <Rating>5</Rating>
                        <Floors xsi:nil="true"/>
                        <Data>
                           <Info>
                              <Name>W St.petersburg</Name>
                              <Area xsi:nil="true"/>
                              <Location>City centre</Location>
                              <Desc>This 5 star hotel is located in the city centre of St Petersburg and was established in 2011. It is close to the St.Isaac's Cathedral and the nearest station is Admiralteyskaya station. The Hotel has a restaurant, 2 bars, a conference room, a coffee shop, an indoor swimming pool and a fitness centre/gym. All 137 rooms are equipped with minibar, hairdryer, safe, trouser press and air conditioning.</Desc>
                              <Address>6 Voznesensky Prospect, St. Petersburg, 190000, St Petersburg, Russia</Address>
                           </Info>
                        </Data>
                        <Phones/>
                        <Fax>+7 812 6106160</Fax>
                        <Images>
                           <Image>
                              <Path>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/lr/ext.jpg</Path>
                              <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/ext-t.jpg</Icon>
                           </Image>
                           <Image>
                              <Path>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/lr/unknown.jpg</Path>
                              <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/unknown-t.jpg</Icon>
                           </Image>
                           <Image>
                              <Path>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/lr/bed room.jpg</Path>
                              <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/bed room-t.jpg</Icon>
                           </Image>
                        </Images>
                     </Hotel>			
                     ...
                  </Hotels>
               </HotelStatic>
            </Response>
         </ResponseBin>
      </ns1:hotelsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Элемент Hotel

Элемент

Описание

Допустимые значения

Атрибут Id

Обязательный. Идентификатор отеля в системе Nemo.

Целое число.

CityId

Обязательный. Идентификатор города.

Целое число.

CountryId

Обязательный. Идентификатор страны .

Целое число.

Latitude

Необязательный. Широта.

Вещественное число.

Longitude

Необязательный. Долгота.

Вещественное число.

Rating

Необязательный. Рейтинг.

Вещественное число.

Floors

Необязательный. Количество этажей

Целое число.

Data

Необязательный.

Набор элементов Info.

Phones

Необязательный. Массив телефонов.

Набор элементов Phone.

Fax

Необязательный. Факс.

Строка в произвольном формате.

Images

Необязательный. Маcсив изображений.

Набор элементов Image.

Элемент Info.

Элемент

Описание

Допустимые значения

Name

Обязательный. Наименование отеля.

Строка в произвольном формате.

Area

Необязательный. Описание места расположения отеля.

Строка в произвольном формате.

Location

Необязательный. Район города.

Строка в произвольном формате.

Desc

Необязательный. Описание отеля.

Строка в произвольном формате.

Address

Необязательный. Адрес отеля.

Строка в произвольном формате.

Элемент Phones.

Элемент

Описание

Допустимые значения

Phone

Обязательный. Телефон.

Строка в произвольном формате.

Элемент Image.

Элемент

Описание

Допустимые значения

Path

Необязательный. Путь к полному изображению.

Строка в произвольном формате.

Icon

Необязательный. Путь к миниатюре, иконке.

Строка в произвольном формате.

Ошибки

Источник — https://support.nemo.travel/index.php?title=Агентский_API_Отели&oldid=3827