Открыть главное меню

Изменения

Агентский API Отели

9075 байт добавлено, 18:45, 6 мая 2019
Нет описания правки
{{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/"
| Латинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Ответ ====
<div class="mw-collapsible-content">
Система по заданным параметрам ищет отели и возвращает результаты поиска. Все результаты поиска хранятся в базе Nemo определенный срок и доступны для бронирования по идентификатору CacheId.
Атрибут Currency - код валюты.
|}
</div>
</div>
==== Ошибки ====
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=HotelExtInfo
<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/"
| Латинские буквы и цифры. Всего 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/"
Атрибут Currency - код валюты.
|}
</div>
</div>
==== Ошибки ====
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=Penalty
<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/"
| Латинские буквы и цифры. Всего 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">
Атрибут: Currency - код валюты.
|}
</div>
</div>
==== Ошибки ====
== Бронирование ==
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Запрос ====
<div class="mw-collapsible-content">
Схема запроса позволяет указывать несколько услуг для бронирования сразу. Это было сделано с заделом на возможность расширения функциональности в будущем при сохранении совместимости.
| Латинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Ответ ====
<div class="mw-collapsible-content">
После выполнения запроса сразу поступит информация о бронировании. В первую очередь нужно внимательно проверить статусы &lt;Status&gt; всех услуг в бронировании. Если бронировалась услуга со статусом в результатах поиска RQ (по запросу), то статус скорее всего будет не равен «booked». Через некоторое время проверять реальный статус бука отправляя запрос на чтение данных о бронировании.
Информация о клиентах заказа полностью повторяет структуру запроса.
</div>
</div>
==== Ошибки ====
== Подтверждение бронирования ==
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">
==== Запрос ====
<div class="mw-collapsible-content">
Подтверждение бронирования заказа.
 
Для успешного запроса нужно указать:
#Номер заказа в системе.
#ID клиента.
#API ключ.
'''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=ConfirmBooking
<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://trunktst.mlsdnemo-ibe.rucom/wsdev/?version%3D1.0%26for%3DConfirmBooking">
<soapenv:Header/>
<soapenv:Body>
<RequestBin>
<Request>
<BookingId>179547</BookingId>
</Request>
<Source>
</syntaxhighlight>
Элемент '''Request'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width= Выгрузка актуальных данных по заказу(ам) "300" | Описание! scope="col" width="300" | Допустимые значения|-Используется для экспорта бронирований и для обновления данных | BookingID| Обязательный. Идентификатор заказа в локальной клиентской базесистеме Nemo.| Целое число|}
Элемент '''WSDLSource''' (тестовый сервер){| style="width: http://tst.nemo-ibe.com/wsdev/wsdl.php?for800px" class=Export"wikitable"|-! scope="col" width=== Запрос ===="200" | Элемент<syntaxhighlight lang! scope="xmlcol" line enclosewidth="div300" style| Описание! scope="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;col"><soapenv:Envelope xmlns:soapenvwidth="http://schemas300" | Допустимые значения|-| ClientID| Обязательный.xmlsoapID клиента в системе Nemo.org/soap/envelopeМожно посмотреть/добавить в "Администрирование" xmlns:ver="http://tst.nemoВеб-ibeслужба.com/wsdev/?version%3D1Авторизация".0%26for%3DExport"> <soapenv:Header/>| Целое число. <soapenv:Body>|- <ver:export>| APIKey <RequestBin> <Request> <Export> <Items> <!| Обязательный. APIKey --Zero or more repetitions:-->секретный ключ доступа к API Nemo. <Item Id=Можно посмотреть/добавить в "Администрирование" ⇨ "386621Веб-служба. Авторизация"/>. </Items>| Латинские буквы и цифры. Всего 32 символа. </Export>|} </Request> <Sourcediv> <ClientId></ClientId> <APIKey></APIKey> <Language>ru</Language> <Currency>RUB</Currency> </Source> </RequestBin> </ver:export> </soapenv:Body></soapenv:Envelope></syntaxhighlightdiv>
В запросе нужно указать Id заказа, который был получен в результате бронирования.<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%3DExport" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance3DConfirmBooking"> <SOAP-ENV:Body> <ns1:exportResponseconfirmResponse> <ResponseBin> <Response> <ExportBooks> <ItemsBook> <Item Id="386621"> 179547<Hotel /Id="1872666"> <SupplierStatus>GTAbooked</SupplierStatus> <CityId/Book>22046 </CityIdBooks> <DateBegin/Response>2013-10-15 </DateBeginResponseBin> <DateEnd/ns1:confirmResponse>2013-10-18 </DateEndSOAP-ENV:Body> <CacheId/SOAP-ENV:Envelope>1872666</CacheIdsyntaxhighlight> <Name/div>ADLON KEMPINSKI</Namediv> <Categories> <Category Id="1">=== Ошибки ==== <Rooms> <Room Count="1" Id="1" ServiceIdВыгрузка актуальных данных по заказу(ам) =="1"/> <Room Count="1" Id="2" ServiceId="2"/>Используется для экспорта бронирований и для обновления данных в локальной клиентской базе.  <'''WSDL''' (тестовый сервер): http://Rooms> <TotalPrice Currency="RUB">74733tst.84</TotalPrice> <nemo-ibe.com/Category> <wsdev/Categories>wsdl.php?for=Export <Services> <Service Iddiv class="1toccolours mw-collapsible mw-collapsed" Statusstyle="OKwidth:1000px"> ==== Запрос ====<Descdiv class="mw-collapsible-content">Standard Twin</Desc> <Meal>Full Breakfast</Meal> <Price Currencysyntaxhighlight lang="RUBxml" line enclose=">37366.92</Price> </Service> <Service Id=div"2" Statusstyle="OK"> <Descfont-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">Standard Twin</Desc> <Meal>Full Breakfast</Meal> <Price Currencysoapenv:Envelope xmlns:soapenv="RUB">37366http://schemas.xmlsoap.92<org/Price> <soap/Service> <envelope/Services>" <Rooms>xmlns:ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DExport"> <Room Id="1" Type="TWIN"soapenv:Header/> <Room Id="2" Type="SNGL"/soapenv:Body> </Roomsver:export> </HotelRequestBin> <Type>HOTELS</TypeRequest> <Status>waiting</StatusExport> <PricesItems> <Price Currency!--Zero or more repetitions:--> <Item Id="RUB386621"/>74733.84 </PriceItems> <Charges Currency="RUB"/Export>0 </ChargesRequest> <Source> <Commission Currency="RUB"ClientId>0</CommissionClientId> <Penalty Currency="RUB"APIKey></APIKey> <Language>0ru</PenaltyLanguage> <TotalPrice Currency=">RUB">74733.84</TotalPriceCurrency> </PricesSource> <Dates/RequestBin> <BookingDate/ver:export>2013-08-01 20:21:47 </BookingDatesoapenv:Body> <UpdateDate>2013-08-01 20/soapenv:35:01</UpdateDateEnvelope> <CancelDate xsi:nil="true"/syntaxhighlight> <PenaltyDate>2013-07-31 19Элемент '''Item'''{| style="width:10:37</PenaltyDate>800px" class="wikitable" <AutoCancelDate>2013-08|-01 20:23:47</AutoCancelDate> <ConfirmationLimit/>! scope="col" width="200" | Элемент </Dates>! scope="col" width="300" | Описание <Statuses>! scope="col" width="300" | Допустимые значения <PaymentStatus>1</PaymentStatus>|- <DocumentStatus>1</DocumentStatus>| Атрибут Id| Обязательный. Идентификатор заказа в системе Nemo. <DeliveryStatus>1</DeliveryStatus>| Целое число <InvoiceStatus>1</InvoiceStatus>|} <ProblemStatus>1</ProblemStatus> </Statuses>Элемент '''Source''' <Customer> <Person Number{| style="width: 800px" class="1wikitable"/> </Customer>|- <Persons> <Person Number! scope="1col"/> <Person Numberwidth="2200"/>| Элемент <Person Number! scope="3col" width="300"/>| Описание </Persons>! scope="col" width="300" | Допустимые значения </Item>|- </Items>| ClientID <Persons>| Обязательный. ID клиента в системе Nemo. <Person Number=Можно посмотреть/добавить в "1Администрирование">⇨ "Веб-служба. Авторизация". <Lastname>IVANOV</Lastname>| Целое число. <Name>IVAN</Name>|- <Middlename>IVANOVICH<| APIKey| Обязательный. APIKey - секретный ключ доступа к API Nemo.Можно посмотреть/Middlename> <DateOfBirth xsi:nil=добавить в "Администрирование"true"/>Веб-служба. Авторизация".| Латинские буквы и цифры. Всего 32 символа.|} <Phone/div>+79871231212</Phonediv> <Email>m.rudenko@mutediv class="toccolours mw-collapsible mw-lab.com</Email> <Gender xsi:nilcollapsed" style="truewidth:1000px"/> <Document Type="P=== Ответ ====<div class="mw-collapsible-content"> <Series>1811</Series>Ответ содержит элементы результатов бронирований. См. описание выше. <Number>912219</Number> <IssueDate>2012syntaxhighlight lang="xml" line enclose="div" style="font-12-12 00size:009pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin:00</IssueDate10px 0;"> <ExpiryDate>2014SOAP-12ENV:Envelope xmlns:SOAP-12 00ENV="http:00:00</ExpiryDate> </Document> <schemas.xmlsoap.org/soap/envelope/Person>" <Person Numberxmlns:ns1="2"> <Lastname>PETROV<http://Lastname> <Name>IVAN<tst.nemo-ibe.com/Name> <Middlename>MIKHAILOVICH<wsdev/Middlename>?version%3D1.0%26for%3DExport" <DateOfBirth xmlns:xsi:nil="true"http:/> <Phone>+79871231212</Phonewww.w3.org/2001/XMLSchema-instance"> <Email>m.rudenko@muteSOAP-lab.com</EmailENV:Body> <Gender xsins1:nil="true"/exportResponse> <Document Type="P"ResponseBin> <SeriesResponse>1866 </SeriesExport> <NumberItems> <Item Id="386621">913319 </NumberHotel Id="1872666"> <IssueDateSupplier>2012-12-12 00:00:00GTA</Supplier> <CityId>22046</IssueDateCityId> <ExpiryDateDateBegin>20142013-1210-12 00:00:0015</ExpiryDateDateBegin> <DateEnd>2013-10-18</DocumentDateEnd> </PersonCacheId> 1872666<Person Number="3"/CacheId> <LastnameName>SIDOROVADLON KEMPINSKI</LastnameName> <NameCategories>IVAN </NameCategory Id="1"> <Middlename>SERGEEVICH</MiddlenameRooms> <DateOfBirth xsi:nilRoom Count="1" Id="1" ServiceId="true1"/> <Phone>+79871231212 <Room Count="1" Id="2" ServiceId="2"/Phone> <Email>m.rudenko@mute-lab.com </EmailRooms> <Gender xsi:nilTotalPrice Currency="trueRUB">74733.84</TotalPrice> <Document Type="P"/Category> <Series>1866</SeriesCategories> <NumberServices> <Service Id="1" Status="OK"> <Desc>913319Standard Twin</NumberDesc> <IssueDateMeal>2012-12-12 00:00:00Full Breakfast</IssueDateMeal> <ExpiryDatePrice Currency="RUB">2014-12-12 00:00:00</ExpiryDate37366.92</Price> </DocumentService> </PersonService Id="2" Status="OK"> </PersonsDesc> Standard Twin</ExportDesc> </ResponseMeal> Full Breakfast</ResponseBinMeal> </ns1:exportResponsePrice Currency="RUB"> 37366.92</SOAP-ENV:BodyPrice> </SOAP-ENV:EnvelopeService> </syntaxhighlightServices> <Rooms>Формат ответа аналогичен результату бронирования. ==== Ошибки <Room Id="1" Type="TWIN"/> <Room Id="2" Type="SNGL"/> </Rooms>== Аннуляция заказа == </Hotel>'''WSDL''' (тестовый сервер): http: <Type>HOTELS</Type> <Status>waiting</tst.nemo-ibe.com/wsdev/wsdl.php?for=CancelBooking==== Запрос ====Status> <Prices> <syntaxhighlight langPrice Currency="xmlRUB" line enclose>74733.84</Price> <Charges Currency="divRUB" style>0</Charges> <Commission Currency="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"RUB">0</Commission> <soapenv:Envelope xmlns:soapenvPenalty Currency="http:RUB">0<//schemasPenalty> <TotalPrice Currency="RUB">74733.xmlsoap.org84</soapTotalPrice> </envelope/" Prices> <Dates>xmlns <BookingDate>2013-08-01 20:ver="http21:47<//tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCancelBooking"BookingDate> <soapenvUpdateDate>2013-08-01 20:35:Header01</UpdateDate> <soapenvCancelDate xsi:Bodynil="true"/> <ver:cancelPenaltyDate> 2013-07-31 19:10:37<RequestBin/PenaltyDate> <RequestAutoCancelDate> 2013-08-01 20:23:47<CancelBooking> <Item Id="386621"/AutoCancelDate> <ConfirmationLimit/CancelBooking> </RequestDates> <SourceStatuses> <ClientIdPaymentStatus>1</ClientIdPaymentStatus> <APIKeyDocumentStatus>1</APIKeyDocumentStatus> <LanguageDeliveryStatus>ru1</LanguageDeliveryStatus> <CurrencyInvoiceStatus>RUB1</CurrencyInvoiceStatus> <ProblemStatus>1</SourceProblemStatus> </RequestBinStatuses> </ver:cancelCustomer> <Person Number="1"/soapenv:Body> </soapenv:EnvelopeCustomer> </syntaxhighlightPersonsЭлемент '''Item'''{| style <Person Number="width: 800px1" class/> <Person Number="wikitable2"/>|-! scope <Person Number="col3" width="200" | Элемент/> </Persons>! scope="col" width </Item> </Items> <Persons> <Person Number="3001" | Описание>! scope="col" width="300" | Допустимые значения <Lastname>IVANOV</Lastname>|- <Name>IVAN</Name>| Атрибут Id <Middlename>IVANOVICH</Middlename>| Обязательный. Идентификатор заказа в системе Nemo. <DateOfBirth xsi:nil="true"/>| Целое число <Phone>+79871231212</Phone>|} <Email>m.rudenko@mute-lab.com</Email> <Gender xsi:nil="true"/> <Document Type==== Ответ ===="P"> <Series>1811</Series> <Number>912219</Number> <IssueDate>2012-12-12 00:00:00</IssueDate> <ExpiryDate>2014-12-12 00:00:00</ExpiryDate> </Document> </Person> <Person Number="2"> <Lastname>PETROV</Lastname> <Name>IVAN</Name> <Middlename>MIKHAILOVICH</Middlename> <DateOfBirth xsi:nil="true"/> <Phone>+79871231212</Phone> <Email>m.rudenko@mute-lab.com</Email> <Gender xsi:nil="true"/> <Document Type="P"> <Series>1866</Series> <Number>913319</Number> <IssueDate>2012-12-12 00:00:00</IssueDate> <ExpiryDate>2014-12-12 00:00:00</ExpiryDate> </Document> </Person> <Person Number="3"> <Lastname>SIDOROV</Lastname> <Name>IVAN</Name> <Middlename>SERGEEVICH</Middlename> <DateOfBirth xsi:nil="true"/> <Phone>+79871231212</Phone> <Email>m.rudenko@mute-lab.com</Email> <Gender xsi:nil="true"/> <Document Type="P"> <Series>1866</Series> <Number>913319</Number> <IssueDate>2012-12-12 00:00:00</IssueDate> <ExpiryDate>2014-12-12 00:00:00</ExpiryDate> </Document> </Person> </Persons> </Export> </Response> </ResponseBin> </ns1:exportResponse> </SOAP-ENV:Body></SOAP-ENV:Envelope></syntaxhighlight> Формат ответа аналогичен результату бронирования.</div></div>см. результаты бронирования.==== Ошибки ====* '''You can cancel only booked order''' - возникает при попытке аннулировать незабронированный заказ.* '''Invalid Booking Id N''' - заказ с номером N отсутствует.
= Статические данные =Для работы с веб-сервисом Nemo необходимо выгрузить статичные данные. Это данные о странах, городах и отелях.== Страна Аннуляция заказа =='''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CountryStaticCancelBooking<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%3DCountryStatic3DCancelBooking"> <soapenv:Header/> <soapenv:Body> <ver:countriescancel> <RequestBin> <Request> <CountryStaticCancelBooking> <Item Id="386621"/CountryStatic> </CancelBooking> </Request> <Source> <ClientId></ClientId> <APIKey></APIKey> <Language>ru</Language> <Currency>RUB</Currency> </Source> </RequestBin> </ver:countriescancel> </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
Элемент '''RequestItem'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Атрибут Id| Обязательный. Идентификатор заказа в системе Nemo.| Целое число|} Элемент '''Source'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CountryStaticClientID| Пустой элементОбязательный. ID клиента в системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Целое число.| <br-| APIKey| Обязательный. APIKey - секретный ключ доступа к API Nemo.Можно посмотреть/>добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Латинские буквы и цифры. Всего 32 символа.
|}
</div>
</div>
==== Ответ ====
см. результаты бронирования.==== Ошибки ====* '''You can cancel only booked order''' - возникает при попытке аннулировать незабронированный заказ.* '''Invalid Booking Id N''' - заказ с номером N отсутствует. = Статические данные =Для работы с веб-сервисом Nemo необходимо выгрузить статичные данные. Это данные о странах, городах и отелях.== Страна =='''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CountryStatic<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-ENVsoapenv:Envelope xmlns:SOAP-ENVsoapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCountryStatic" >xmlns <soapenv:xsi="http://www.w3.org/2001Header/XMLSchema-instance"> <SOAP-ENVsoapenv:Body> <ns1ver:countriesResponsecountries> <ResponseBinRequestBin> <ResponseRequest>
<CountryStatic>
<Countries> <Country Id="4"> <Code>AF </CodeCountryStatic> <Continent>asia </ContinentRequest> <DataSource> <Info Language="RU"> <NameClientId>Афганистан</NameClientId> </Info> <Info Language="EN"APIKey> <Name>Afghanistan</NameAPIKey> </InfoLanguage> ru</DataLanguage> </Country> </CountriesCurrency> RUB</CountryStaticCurrency> </ResponseSource> </ResponseBinRequestBin> </ns1ver:countriesResponsecountries> </SOAP-ENVsoapenv:Body></SOAP-ENVsoapenv:Envelope>
</syntaxhighlight>
Элемент '''CountryStaticRequest'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CountriesCountryStatic| ОбязательныйПустой элемент| Набор элементов Country<br/>
|}
Элемент '''CountrySource'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| Атрибут IdClientID| Обязательный. Идентификатор страны (ISO)ID клиента в системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".| Целое число.
|-
| CodeAPIKey| Обязательный. Код страны ISOAPIKey - секретный ключ доступа к API Nemo.| Строка из 2-х латинских букв|Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-| Continent| Обязательный. Название континентаслужба.| СтрокаАвторизация".|-| Data| ОбязательныйЛатинские буквы и цифры. Информация требующая перевода.| Набор элементов InfoВсего 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%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></syntaxhighlight> Элемент '''InfoCountryStatic'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Допустимые значения
|-
| Атрибут LanguageCountries| Обязательный. Язык в котором представлена информация.| Строка из 2-х латинских букв.|-| Name| Обязательный. Наименование страны.| Строка в произвольном формате.Набор элементов Country
|}
==== Ошибки ==== == Город ==Параметры поиска всех услуг требуют указания ID города. Города выгружаются по каждой стране следующим запросом: Элемент '''WSDLCountry''' (тестовый сервер){| style="width: http://tst.nemo-ibe.com/wsdev/wsdl.php?for800px" class=CityStatic"wikitable"|-! scope==== Запрос ====<syntaxhighlight lang"col" width="xml200" line enclose| Элемент! scope="divcol" stylewidth="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;300">| Описание<soapenv:Envelope xmlns:soapenv! scope="http://schemas.xmlsoap.org/soap/envelope/col" xmlns:verwidth="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic300">| Допустимые значения <soapenv:Header/>|- <soapenv:Body>| Атрибут Id <ver:cities>| Обязательный. Идентификатор страны (ISO). <RequestBin>| Целое число <Request>|- <CityStatic>| Code <CountryId>4</CountryId> </CityStatic> </Request> <Source> <ClientId></ClientId> <APIKey></APIKey> <Language>ru</Language> <Currency>RUB</Currency> </Source> </RequestBin> </ver:cities> </soapenv:Body></soapenv:Envelope></syntaxhighlight> Элемент '''CityStatic'''| Обязательный. Код страны ISO.{| style="width: 800px" class="wikitable"Строка из 2-х латинских букв
|-
| Continent| Обязательный. Название континента.| Строка.|-| Data| Обязательный. Информация требующая перевода.| Набор элементов Info.|} Элемент '''Info'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание
! scope="col" width="300" | Допустимые значения
|-
| CountryIdАтрибут Language| Обязательный. Идентификатор Язык в котором представлена информация.| Строка из 2-х латинских букв.|-| Name| Обязательный. Наименование страны.| Целое числоСтрока в произвольном формате.
|}
</div>
</div>
 
==== Ошибки ====
==Город == Ответ Параметры поиска всех услуг требуют указания ID города. Города выгружаются по каждой стране следующим запросом: '''WSDL''' (тестовый сервер): http://tst.nemo-ibe.com/wsdev/wsdl.php?for=CityStatic <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-ENVsoapenv:Envelope xmlns:SOAP-ENVsoapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DCityStatic"> <SOAP-ENVsoapenv:Header/> <soapenv:Body> <ns1ver:citiesResponsecities> <ResponseBinRequestBin> <ResponseRequest>
<CityStatic>
<Cities> <City Id="1"> <Name>Кабул</Name> <CountryId>4</CountryId> <Data> <Info Language="EN"> <Name>Kabul </NameCityStatic> </InfoRequest> <Info Language="RU"Source> <NameClientId>Кабул</NameClientId> </InfoAPIKey> </DataAPIKey> </CityLanguage> ru<City Id="204793"/Language> <NameCurrency>AibakRUB</NameCurrency> <CountryId>4 </CountryIdSource> <Data/RequestBin> <Info Language="EN"> <Name>Aibak </Namever:cities> </Infosoapenv:Body> <Info Language="RU"> <Name>Aibak</Namesoapenv:Envelope> </Infosyntaxhighlight> </Data> </City>Элемент '''CityStatic''' <City Id{| style="width: 800px" class="204785wikitable"> <Name>Anar Darah</Name>|- <CountryId>4</CountryId>! scope="col" width="200" | Элемент <Data>! scope="col" width="300" | Описание <Info Language! scope="ENcol"> <Name>Anar Darah</Name> </Info> <Info Languagewidth="RU300">| Допустимые значения <Name>Anar Darah</Name>|- </Info> </Data>| CountryId </City> | Обязательный.Идентификатор страны.. </Cities> </CityStatic> </Response> </ResponseBin>| Целое число </ns1:citiesResponse> </SOAP-ENV:Body></SOAP-ENV:Envelope></syntaxhighlight>|}
Элемент '''CityStaticSource'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CitiesClientID| Обязательный. Массив городовID клиента в системе Nemo. | Набор элементов City|} Элемент '''City'''{| style=Можно посмотреть/добавить в "width: 800pxАдминистрирование" class="wikitableВеб-служба. Авторизация".| Целое число.
|-
! scope="col" width="200" | ЭлементAPIKey! scope="col" width="300" | ОписаниеОбязательный. APIKey - секретный ключ доступа к API Nemo.! scope=Можно посмотреть/добавить в "colАдминистрирование" width="300" | Допустимые значения|Веб-| Атрибут '''Id'''| Обязательныйслужба. Идентификатор городаАвторизация".| Целое число|-| Name| Название города.| |-| Data| Названия городов на разных языках. В данный момент поддерживаются названия на русском Латинские буквы и английскомцифры.| См. описание элемента Data в ответе получения информации о странеВсего 32 символа.
|}
</div>
</div>
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px">== Ошибки ==Ответ == == Статика по отелям и апартаментам <div class==Этот запрос будет использоваться для выгрузки статичной информации по одному или нескольким отелям. '''WSDL''' (тестовый сервер): http://tst.nemo"mw-collapsible-ibe.com/wsdev/wsdl.php?for=HotelStatic ==== Запрос ====content"><syntaxhighlight lang="xml" line enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;"><soapenvSOAP-ENV:Envelope xmlns:soapenvSOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:verns1="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic3DCityStatic"> <soapenv:Header/> <soapenvSOAP-ENV:Body> <verns1:hotelscitiesResponse> <RequestBinResponseBin> <RequestResponse> <HotelStaticCityStatic> <CityIdCities> <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>58166 </CityIdInfo> </HotelStaticData> </RequestCity> <SourceCity Id="204785"> <ClientIdName>Anar Darah</ClientIdName> <APIKeyCountryId>4</APIKeyCountryId> <Data> <Info Language="EN"> <Name>ruAnar Darah</Name> </Info> <Info Language="RU"> <Name>Anar Darah</Name> </Info> </Data> </City> ... <Currency/Cities>RUB </CurrencyCityStatic> </SourceResponse> </RequestBinResponseBin> </verns1:hotelscitiesResponse> </soapenvSOAP-ENV:Body></soapenvSOAP-ENV:Envelope></syntaxhighlight> Элемент '''HotelsCityStatic'''
{| style="width: 800px" class="wikitable"
|-
! scope="col" width="300" | Допустимые значения
|-
| CityIdCities| Обязательный. Идентификатор города из которого необходимо получить отелиМассив городов.| Целое числоНабор элементов City
|}
Элемент '''City'''{| style="width: 800px" class="wikitable"|-! scope="col" width= Ответ "200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Атрибут '''Id'''| Обязательный. Идентификатор города.| Целое число|-| Name| Название города.| |-| Data| Названия городов на разных языках. В данный момент поддерживаются названия на русском и английском.| См. описание элемента Data в ответе получения информации о стране.|}</div></div> ==== Ошибки ==== == Статика по отелям и апартаментам ==Этот запрос будет использоваться для выгрузки статичной информации по одному или нескольким отелям. '''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;"><SOAP-ENVsoapenv:Envelope xmlns:SOAP-ENVsoapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1ver="http://tst.nemo-ibe.com/wsdev/?version%3D1.0%26for%3DHotelStatic" >xmlns <soapenv:xsi="http://www.w3.org/2001Header/XMLSchema-instance"> <SOAP-ENVsoapenv:Body> <ns1ver:hotelsResponsehotels> <ResponseBinRequestBin> <ResponseRequest> <HotelStatic> <Hotels> <Hotel Id="271714" Apartment="false"> <CityId>58166</CityId> <CountryId>643 </CountryIdHotelStatic> <Latitude xsi:nil="true"/Request> <Longitude xsi:nil="true"/Source> <RatingClientId>3</RatingClientId> <Floors xsi:nil="true"/> <DataAPIKey> <Info> <Name>* Azimut (business)</NameAPIKey> <Area xsi:nil="true"/Language> <Location>Within cityru</LocationLanguage> <DescCurrency>This 3 star hotel is located within the city of St Petersburg.RUB</DescCurrency> <Address>43/1 Lermoutovsky Prospect, St Petersburg, 190103 </AddressSource> </InfoRequestBin> </Dataver:hotels> <Phones> <Phone>812 7402640 </Phonesoapenv:Body> </Phonessoapenv:Envelope> <Fax>812 2518890</Faxsyntaxhighlight> <Images/> </Hotel>Элемент '''Hotels''' <Hotel Id{| style="159535width: 800px" Apartmentclass="falsewikitable"> <CityId>58166</CityId>|- <CountryId>643</CountryId>! scope="col" width="200" | Элемент <Latitude>59.935011</Latitude>! scope="col" width="300" | Описание <Longitude>30.309284</Longitude> <Rating>5</Rating> <Floors xsi:nil! scope="truecol"/> <Data> <Info> <Name>W St.petersburg</Name> <Area xsi:nilwidth="true300"/> <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>| CityId </Image> </Images> </Hotel> | Обязательный.Идентификатор города из которого необходимо получить отели.. </Hotels> </HotelStatic> </Response> </ResponseBin> </ns1:hotelsResponse>| Целое число </SOAP-ENV:Body></SOAP-ENV:Envelope></syntaxhighlight>|} Элемент '''HotelSource'''{| style="width: 800px" class="wikitable"
|-
! scope="col" width="200" | Элемент
! scope="col" width="300" | Допустимые значения
|-
| Атрибут IdClientID| Обязательный. Идентификатор отеля ID клиента в системе Nemo.Можно посмотреть/добавить в "Администрирование" ⇨ "Веб-служба. Авторизация".
| Целое число.
|-
| CityIdAPIKey| Обязательный. Идентификатор города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;">| 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%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> <Latitudexsi: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>| Longitude <Info>| Необязательный. Долгота <Name>W St.petersburg</Name>| Вещественное число. <Area xsi:nil="true"/>|- <Location>City centre</Location>| Rating <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 | Floors 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>| Набор элементов Info <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/ext-t.jpg</Icon>|- </Image>| Phones <Image>| Необязательный <Path>https://www.miki.co.uk/live/hotel/mikiNet/image/v1. Массив телефонов0/RU/44018/406/lr/unknown.jpg</Path>| Набор элементов Phone <Icon>https://www.miki.co.uk/live/hotel/mikiNet/image/v1.0/RU/44018/406/unknown-t.jpg</Icon>|- </Image>| Fax <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> | Необязательный .. Маcсив изображений.| Набор элементов Image. </Hotels> </HotelStatic> </Response> </ResponseBin> </ns1:hotelsResponse> </SOAP-ENV:Body></SOAP-ENV:Envelope>|}</syntaxhighlight> Элемент '''InfoHotel'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scope="col" width="300" | Допустимые значения|-| Name| Обязательный. Наименование отеля.| Строка в произвольном формате.|-| Area| Необязательный. Описание места расположения отеля.| Строка в произвольном формате.|-| Location| Необязательный. Район города.| Строка в произвольном формате.
|-
| DescАтрибут 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| Обязательный. Наименование отеля.| Строка в произвольном формате.|-| Area| Необязательный. Описание места расположения отеля.| Строка в произвольном формате.|-| 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> ==== Ошибки ====
Элемент '''Image'''{| style="width: 800px" class="wikitable"|-! scope="col" width="200" | Элемент! scope="col" width="300" | Описание! scopeСм. также="col" width="300" | Допустимые значения|-| Path| Необязательный. Путь к полному изображению.| Строка в произвольном формате.* [[Агентский интерфейс прикладного программирования (Агентский API)]]|-* [[Схема использования агентского API (workflow)]]| Icon* [[Агентский API Авиабилеты]]| Необязательный. Путь к миниатюре, иконке.| Строка в произвольном формате.|} ==== Ошибки ====* [[Агентский API Оплата]]
'