224
правки
Изменения
Нет описания правки
{{Attention|В системе реализован усовершенствованный API-проект «Nemo Connect», настоятельно рекомендуем подключаться по схеме, описанной в документации по [http://docs.nemo.travel/ ссылке]}}
[[Категория:Агентский API]]
[[Категория:Интеграция]]
[[Файл:Nemo-logo.png|right]]
'''Агентский API ОтелейОтели''' - — система, которая предоставляет возможность поиска и бронирования отелей а так же получение информации о времени и размерах штрафов, уникальной информации об отеле, получение статической информации.
Сервис предназначен для получения списка отелей, удовлетворяющих условиям запроса. В условия запроса входят: идентификатор города, где будет вестись поиск; дата заезда и дата выезда; информация о количестве людей и способе их размещения в комнатах. Так же указываются дополнительные необязательные поля фильтров.
'''WSDL''' (тестовый сервер): [http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelsSearch]
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Запрос ====
<div class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelsSearch">
<!--Zero or more repetitions:-->
<Person Id="1" Type="ADT" Age="30"/>
<Person Id="12" Type="CLD" Age="10"/>
</Persons>
<!--Optional:-->
</soapenv:Body>
</soapenv:Envelope>
</divsyntaxhighlight>
Элемент '''HotelSearch'''
|}
Элемент '''Source'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| ClientID
| Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
| Целое число.
|-
| APIKey
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
| Латинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Ответ ====
<div class="mw-collapsible-content">
Система по заданным параметрам ищет отели и возвращает результаты поиска. Все результаты поиска хранятся в базе Nemo определенный срок и доступны для бронирования по идентификатору CacheId.
Каждый отель содержит:
<source syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelsSearch">
</Hotel>
...
</HotelSearch>
</Response>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</sourcesyntaxhighlight>
Элемент '''Hotel'''
| Элемент Category
|}
Элемент '''Service'''
Атрибут Currency - код валюты.
|}
Элемент '''Room'''
Атрибут Currency - код валюты.
|}
</div>
</div>
==== Ошибки ====
Сервис получения дополнительной информации об отеле требует указания идентификатора отеля в системе Nemo и категории.
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelExtInfo
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Запрос ====
<prediv class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelExtInfo">
</soapenv:Body>
</soapenv:Envelope>
</presyntaxhighlight>
Элемент '''Item'''
|}
Элемент '''Source'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| ClientID| Обязательный. ID клиента в системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Целое число.|-| APIKey| Обязательный. APIKey - секретный ключ доступа к API Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Латинские буквы и цифры. Всего 32 символа.|}</div></div> <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Ответ ====<prediv class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelExtInfo" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <SOAP-ENV:Body> <ns1:extInfoResponse>
<ResponseBin>
<Response>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</presyntaxhighlight>
Элемент '''HotelExtInfo'''
Атрибут Currency - код валюты.
|}
</div>
</div>
==== Ошибки ====
Всегда в явном виде нужно указывать пользователю информацию о штрафах за аннуляцию до бронирования.
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Penalty
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Запрос ====
<prediv class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty">
<soapenv:Header/>
</soapenv:Body>
</soapenv:Envelope>
</presyntaxhighlight>
Элемент '''Item'''
|}
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| ItemDateBeginClientID| Обязательный. Дата начала услуги (дата заселения ID клиента в отель)системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Формат гггг-мм-дд чч:мм:ссЦелое число.
|-
| APIKey| Обязательный. APIKey - секретный ключ доступа к API Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Латинские буквы и цифры. Всего 32 символа.|}</div></div> <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Ответ ====<div class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DPenalty"> <SOAP-ENV:Body> <ns1:penaltyResponse> <ResponseBin> <Response> <Penalty> <ItemDateBegin>2013-10-15 00:00:00</ItemDateBegin> <CancelCharges> <Charge> <DateFrom>2013-10-12 00:00:00</DateFrom> <DateTo>2013-10-15 23:59:59</DateTo> <Money Currency="RUB">74733.84</Money> </Charge> <Charge> <DateFrom>2013-09-23 00:00:00</DateFrom> <DateTo>2013-10-11 00:00:00</DateTo> <Money Currency="RUB">67260.46</Money> </Charge> <Charge> <DateFrom>2013-08-01 17:59:00</DateFrom> <DateTo>2013-09-22 00:00:00</DateTo> <Money Currency="RUB">12455.64</Money> </Charge> </CancelCharges> <ModifyCharges/> </Penalty> </Response> </ResponseBin> </ns1:penaltyResponse> </SOAP-ENV:Body></SOAP-ENV:Envelope></syntaxhighlight> Элемент '''Penalty'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| ItemDateBegin| Обязательный. Дата начала услуги (дата заселения в отель).| Формат гггг-мм-дд чч:мм:сс|-| CancelCharges| Необязательный. Содержит информацию о штрафах за аннуляцию.| Элемент Charge
|-
| ModifyCharges
Атрибут: Currency - код валюты.
|}
</div>
</div>
==== Ошибки ====
==Бронирование = Бронирование =<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Запрос ====
<div class="mw-collapsible-content">
Схема запроса позволяет указывать несколько услуг для бронирования сразу. Это было сделано с заделом на возможность расширения функциональности в будущем при сохранении совместимости.
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Booking
<presyntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DBooking">
<soapenv:Header/>
</soapenv:Body>
</soapenv:Envelope>
</presyntaxhighlight>
Элемент '''Booking'''
|}
Элемент '''Source'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| ClientID
| Обязательный. ID клиента в системе Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
| Целое число.
|-
| APIKey
| Обязательный. APIKey - секретный ключ доступа к API Nemo.
Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
| Латинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Ответ ====
<div class="mw-collapsible-content">
После выполнения запроса сразу поступит информация о бронировании. В первую очередь нужно внимательно проверить статусы <Status> всех услуг в бронировании. Если бронировалась услуга со статусом в результатах поиска RQ (по запросу), то статус скорее всего будет не равен «booked». Через некоторое время проверять реальный статус бука отправляя запрос на чтение данных о бронировании.
<presyntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DBooking"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</presyntaxhighlight>
Структура ответа очень похожа на запрос. Выделяются те же основные элементы.
Информация о клиентах заказа полностью повторяет структуру запроса.
</div>
</div>
==== Ошибки ====
==Подтверждение бронирования ==<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Запрос = Выгрузка актуальных данных по заказу(ам) ===Используется для экспорта бронирований и для обновления данных в локальной клиентской базе<div class="mw-collapsible-content">Подтверждение бронирования заказа.
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=ConfirmBooking
<syntaxhighlight lang="xml" line enclose="div" style== Запрос ====<pre"font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DExport3DConfirmBooking"> <soapenv:Header/> <soapenv:Body> <ver:exportconfirm> <RequestBin> <Request> <ExportBookingId> 179547<Items> <!--Zero or more repetitions:--> <Item Id="386621"/BookingId> </Items> </Export> </Request> <Source> <ClientId></ClientId> <APIKey></APIKey> <Language>ru</Language> <Currency>RUB</Currency> </Source> </RequestBin> </ver:exportconfirm> </soapenv:Body>
</soapenv:Envelope>
</presyntaxhighlight>
==== Ошибки ==== == Аннуляция заказа =='''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CancelBooking<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Запрос ====<div class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCancelBooking"> <soapenv:Header/> <soapenv:Body> <ver:cancel> <RequestBin> <Request> <CancelBooking> <Item Id="386621"/> </CancelBooking> </Request> <Source> <ClientId></ClientId> <APIKey></APIKey> <Language>ru</Language> <Currency>RUB</Currency> </Source> </RequestBin> </ver:cancel> </soapenv:Body></soapenv:Envelope></syntaxhighlight> Элемент '''CountryStaticItem'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CountriesАтрибут Id| Обязательный. Идентификатор заказа в системе Nemo.| Набор элементов CountryЦелое число
|}
Элемент '''CountrySource'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| Атрибут IdClientID| Обязательный. Идентификатор страны (ISO)ID клиента в системе Nemo.| Целое число|Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-| Code| Обязательныйслужба. Код страны ISOАвторизация".| Строка из 2-х латинских буквЦелое число.
|-
| ContinentAPIKey| Обязательный. Название континента.| СтрокаAPIKey - секретный ключ доступа к API Nemo.|Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-| Data| Обязательныйслужба. Информация требующая переводаАвторизация".| Набор элементов InfoЛатинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
==== Ответ ====
см. результаты бронирования.
==== Ошибки ====
* '''You can cancel only booked order''' - возникает при попытке аннулировать незабронированный заказ.
* '''Invalid Booking Id N''' - заказ с номером N отсутствует.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic3DCountryStatic">
<soapenv:Header/>
<soapenv:Body>
<ver:citiescountries>
<RequestBin>
<Request>
<CityStatic> <CountryId>4</CountryIdCountryStatic> </CityStaticCountryStatic>
</Request>
<Source>
</Source>
</RequestBin>
</ver:citiescountries>
</soapenv:Body>
</soapenv:Envelope>
</presyntaxhighlight>
Элемент '''CityStaticRequest'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CountryIdCountryStatic| Пустой элемент| <br/>|} Элемент '''Source'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| ClientID| Обязательный. Идентификатор страныID клиента в системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Целое число.|-| APIKey| Обязательный. APIKey - секретный ключ доступа к API Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Латинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Ответ ====
<prediv class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic3DCountryStatic" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<ns1:citiesResponsecountriesResponse>
<ResponseBin>
<Response>
<CityStaticCountryStatic> <CitiesCountries> <City Country Id="14"> <NameCode>КабулAF</NameCode> <CountryIdContinent>4asia</CountryIdContinent>
<Data>
<Info Language="RU">
<Name>КабулАфганистан</Name>
</Info>
<Info Language="EN">
<Name>Aibak</Name> </Info> <Info Language="RU"> <Name>AibakAfghanistan</Name>
</Info>
</Data>
</CityCountry> <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> ... </CitiesCountries> </CityStaticCountryStatic> </Response> </ResponseBin> </ns1:citiesResponsecountriesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</presyntaxhighlight>
Элемент '''CityStaticCountryStatic'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CitiesCountries| Обязательный. Массив городов. | Набор элементов CityCountry
|}
Элемент '''CityCountry'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| Атрибут '''Id'''| Обязательный. Идентификатор городастраны (ISO).
| Целое число
|-
| NameCode| Обязательный. Код страны ISO.| Строка из 2-х латинских букв|-| Continent| Обязательный. Название городаконтинента.| Строка.
|-
| Data
| Названия городов на разных языкахОбязательный. В данный момент поддерживаются названия на русском и английскомИнформация требующая перевода.| СмНабор элементов Info. описание элемента Data |} Элемент '''Info'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Атрибут Language| Обязательный. Язык в котором представлена информация.| Строка из 2-х латинских букв.|-| Name| Обязательный. Наименование страны.| Строка в ответе получения информации о странепроизвольном формате.
|}
</div>
</div>
==== Ошибки ====
=== Статика по отелям и апартаментам =Город ==Этот запрос будет использоваться для выгрузки статичной информации Параметры поиска всех услуг требуют указания ID города. Города выгружаются по одному или нескольким отелям.каждой стране следующим запросом:
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelStaticCityStatic
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Запрос ====
<prediv class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic3DCityStatic">
<soapenv:Header/>
<soapenv:Body>
<ver:hotelscities>
<RequestBin>
<Request>
<HotelStaticCityStatic> <CityIdCountryId>581664</CityIdCountryId> </HotelStaticCityStatic>
</Request>
<Source>
</Source>
</RequestBin>
</ver:hotelscities>
</soapenv:Body>
</soapenv:Envelope>
</presyntaxhighlight>
Элемент '''HotelsCityStatic'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CityIdCountryId| Обязательный. Идентификатор города из которого необходимо получить отелистраны.
| Целое число
|}
Элемент '''Source'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| ClientID| Обязательный. ID клиента в системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Целое число.|-| APIKey| Обязательный. APIKey - секретный ключ доступа к API Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Латинские буквы и цифры. Всего 32 символа.|}</div></div> <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Ответ ====<prediv class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><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-instance3DCityStatic"> <SOAP-ENV:Body> <ns1:hotelsResponsecitiesResponse>
<ResponseBin>
<Response>
<HotelStaticCityStatic> <HotelsCities> <Hotel City Id="271714" Apartment="false1"> <CityIdName>58166Кабул</CityIdName> <CountryId>6434</CountryId> <Latitude xsi:nil="true"/> <Longitude xsi:nil="true"/> <Rating>3</Rating> <Floors xsi:nil="true"/>
<Data>
<InfoLanguage="EN"> <Name>* Azimut (business)Kabul</Name> <Area xsi:nil="true"/Info> <Location>Within city</LocationInfo Language="RU"> <DescName>This 3 star hotel is located within the city of St Petersburg.Кабул</Desc> <Address>43/1 Lermoutovsky Prospect, St Petersburg, 190103</AddressName>
</Info>
</Data>
<Data>
<InfoLanguage="EN"> <Name>W St.petersburgAibak</Name> <Area xsi:nil="true"/Info> <Location>City centre</LocationInfo Language="RU"> <DescName>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.Aibak</Desc> <Address>6 Voznesensky Prospect, St. Petersburg, 190000, St Petersburg, Russia</AddressName>
</Info>
</Data>
</Response>
</ResponseBin>
</ns1:hotelsResponsecitiesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</presyntaxhighlight>
Элемент '''HotelCityStatic'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| Атрибут IdCities| Обязательный. Идентификатор отеля в системе NemoМассив городов.| Целое число.Набор элементов City|-}| CityId| Обязательный. Идентификатор города.Элемент '''City'''{| Целое число.style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | CountryIdЭлемент! scope="col" width="300" | Обязательный. Идентификатор страны .Описание! scope="col" width="300" | Целое число.Допустимые значения
|-
| LatitudeАтрибут '''Id'''| НеобязательныйОбязательный. ШиротаИдентификатор города.| Вещественное Целое число.
|-
| LongitudeName| Необязательный. ДолготаНазвание города.| Вещественное число.
|-
| RatingData| НеобязательныйНазвания городов на разных языках. РейтингВ данный момент поддерживаются названия на русском и английском.| Вещественное числоСм.|-| Floors| Необязательный. Количество этажей| Целое число.|-| описание элемента Data| Необязательныйв ответе получения информации о стране.| Набор элементов Info.}|-</div>| Phones</div>| Необязательный. Массив телефонов.| Набор элементов Phone.|-| Fax| Необязательный. Факс.| Строка в произвольном формате.|-==== Ошибки ====| Images| Необязательный. Маcсив изображений.== Статика по отелям и апартаментам ==| Набор элементов ImageЭтот запрос будет использоваться для выгрузки статичной информации по одному или нескольким отелям.|}
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelStatic <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Запрос ====<div class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><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></syntaxhighlight> Элемент '''InfoHotels'''{| style="width: 800px" class="wikitable"|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| NameCityId| Обязательный. Наименование отеляИдентификатор города из которого необходимо получить отели.| Строка в произвольном формате.Целое число|} Элемент '''Source'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | AreaЭлемент! scope="col" width="300" | Необязательный. Описание места расположения отеля.! scope="col" width="300" | Строка в произвольном формате.Допустимые значения
|-
| LocationClientID| НеобязательныйОбязательный. Район городаID клиента в системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Строка в произвольном форматеЦелое число.
|-
| APIKey| Обязательный. APIKey - секретный ключ доступа к API Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Латинские буквы и цифры. Всего 32 символа.|}</div></div> <div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">==== Ответ ====<div class="mw-collapsible-content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><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></syntaxhighlight> Элемент '''Hotel'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Атрибут Id| Обязательный. Идентификатор отеля в системе Nemo.| Целое число.|-| CityId| Обязательный. Идентификатор города.| Целое число.|-| CountryId| Обязательный. Идентификатор страны .| Целое число.|-| Latitude| Необязательный. Широта.| Вещественное число.|-| Longitude| Необязательный. Долгота.| Вещественное число.|-| Rating| Необязательный. Рейтинг.| Вещественное число.|-| Floors| Необязательный. Количество этажей| Целое число.|-| Data| Необязательный.| Набор элементов Info.|-| Phones| Необязательный. Массив телефонов.| Набор элементов Phone.|-| Fax| Необязательный. Факс.| Строка в произвольном формате.|-| Images| Необязательный. Маcсив изображений.| Набор элементов Image.|} Элемент '''Info'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание ! scope="col" width="300" | Допустимые значения|-| Name| Обязательный. Наименование отеля.| Строка в произвольном формате.|-| AddressArea| Необязательный. Адрес Описание места расположения отеля.
| Строка в произвольном формате.
|-| Location| Необязательный. Район города.| Строка в произвольном формате.|-| Desc| Необязательный. Описание отеля.| Строка в произвольном формате.|-| Address| Необязательный. Адрес отеля.| Строка в произвольном формате.|} Элемент '''Phones'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Phone| Обязательный. Телефон.| Строка в произвольном формате.|} Элемент '''Image'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Path| Необязательный. Путь к полному изображению.| Строка в произвольном формате.|-| Icon| Необязательный. Путь к миниатюре, иконке.| Строка в произвольном формате.|}</div></div> ==== Ошибки ====
==См. также== Ошибки ====* [[Агентский интерфейс прикладного программирования (Агентский API)]]* [[Схема использования агентского API (workflow)]]* [[Агентский API Авиабилеты]]* [[Агентский API Оплата]]