Sletat Ru Provider API - История изменений

Vm: /* Service Description */

2016-02-02T09:53:59Z

‎Service Description

Vm: /* Tour Search */

2016-01-29T08:41:14Z

‎Tour Search

Vm: /* Tour Search */

2016-01-29T08:39:54Z

‎Tour Search

Vm: /* Service Description */

2016-01-29T08:36:09Z

‎Service Description

Vm: /* Tour Search */

2016-01-27T08:56:55Z

‎Tour Search

Vm: /* Returning Meal Options */

2016-01-21T13:34:53Z

‎Returning Meal Options

Vm: /* Актуализация тура */

2016-01-21T13:28:29Z

‎Актуализация тура

Внесённые изменения

Vm: /* Tour Search */

2016-01-21T13:04:24Z

‎Tour Search

Внесённые изменения

Vm: /* Поиск туров */

2016-01-21T12:44:54Z

‎Поиск туров

Vm: /* Выгрузка списка валют */

2016-01-21T12:36:40Z

‎Выгрузка списка валют

@@ Строка 28: / Строка 28: @@
 All methods should return XML in UTF-8.
-All parameters, which are not marked as "required", are optional for the client side only. '''It is mandatory to process all the parameters for the server side.'''
+All parameters, that are not marked as "required", are optional for the client side only. '''It is mandatory to process all the parameters for the server side.'''
 The result of the request should match to the specified parameters strictly.

@@ Строка 380: / Строка 380: @@
 |-
 |tourEndDate
-|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
+|Tour end date (arriving date) in format dd.MM.yyyy (for example: 31.12.2015).
 |-
 |'''nights'''
@@ Строка 441: / Строка 441: @@
 * 1024 – combined tour;
 * 2048 – tour with obligation (shopping tour);
-* 4096 – зарезервировано для использования системой;
+* 4096 – reserved for system use;
-* 8192 – экскурсионный тур;
+* 8192 – excursion tour;
 |-
 |description

@@ Строка 290: / Строка 290: @@
 |excludeUsualTours
 |Int32
-|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
+|If the value is "1", the usual tours (which are not combined, not excursion tours and not shop tours) must be excluded from the result. If the value is "0" or the parameter is missing, those tours must be included into the result.
 |-
 |excludeCombined
 |Int32
-|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
+|If the value is "1", the combined tours (the tourist visits a few resorts during the tour) must be excluded from the result. If the value is "0" or the parameter is missing, those tours must be included into the result.
 |-
 |excludeShopTours
 |Int32
-|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
+|If the value is "1", the shop tours and the tours with the obligations must be excluded from the result. If the value is "0" or the parameter is missing, those tours must be included into the result.
 |-
 |excludeExcursionTours
 |Int32
-|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
+|If the value is "1", the excursion tours must be excluded from the result. If the value is "0" or the parameter is missing, those tours must be included into the result.
 |-
 |}

@@ Строка 28: / Строка 28: @@
 All methods should return XML in UTF-8.
-Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''
+All parameters, which are not marked as "required", are optional for the client side only. '''It is mandatory to process all the parameters for the server side.'''
-Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.
+The result of the request should match to the specified parameters strictly.
 Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

@@ Строка 373: / Строка 373: @@
 |Arbitrary name for hotel accommodation preferences, e.g. DBL, TRP, 2 ADL + 1 CH (2-12), 2 ADL + INF). The name should express age of children (if the number of children older than 0 y.o. was specified) or indicate the request for accommodation of an infant (+ INF) respectively.
 |-
-|roomTypeName
+|'''roomTypeName'''
 |Name of the room type, e.g. standard, deluxe, family, deluxe super, ocean view.
 |-

@@ Строка 163: / Строка 163: @@
 * id – identifier of the meal type (optional; if specified, only one entry is queried)
-'''Формат выдачи:'''
+'''The output format:'''
   <getMealsResult version="1.0">

@@ Строка 191: / Строка 191: @@
 The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).
-=== Поиск туров ===
+=== Tour Search ===
-Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.
+The tour search method has multiple parameters of search and tour filtration.  The method should return only the cheapest deals, filtered out by a specified parameter. The number of returned tours is regulated by the parameter '''count'''.
-'''Формат запроса:''' ?action=GetTours
+'''Format of the query:''' ?action=GetTours
-'''Параметры:'''
+'''Parameters:'''
 {| class="wikitable"
-|Параметр; '''обязательный'''
+|Parameter; '''required'''
-|Тип данных
+|Type of Data
-|Описание
+|Description
 |-
 |offerId
 |Int64
-|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
+|Unique identifier of the previously found offer.  If specified, all other parameters are unnecessary and should be omitted, as well as the method should return only one entry.
 |-
 |'''count'''
 |Int32
-|Максимальное количество предложений в выдаче.
+|Maximum number of offers returned by the query.
 |-
 |'''countryId'''
 |Int32
-|Идентификатор страны.
+|Country identifier.
 |-
 |'''departCityId'''
 |Int32
-|Идентификатор города вылета.
+|Departure city identifier.
 |-
 |'''dateFrom'''
 |String
-|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
+|First date in the range of departure dates presented in the format dd.MM.yyyy, e.g.  31.12.2015.
 |-
 |'''dateTo'''
 |String
-|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
+|Last date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
 |-
 |'''adults'''
 |Int32
-|Количество взрослых.
+|Number of adults.
 |-
 |'''kids'''
 |Int32
-|Количество детей.
+|Number of children.
 |-
 |kidsAges
 |String
-|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
+|Number of full years of age of each child, transmitted as a string, enumeration separated by comma, e.g. 3, 6. Values 0 or 1 have been used to indicate age of infants.
 |-
 |'''nightsMin'''
 |Int32
-|Минимальное количество ночей в туре.
+|Minimum number of nights in the tour.
 |-
 |'''nightsMax'''
 |Int32
-|Максимальное количество ночей в туре.
+|Maximum number of nights in the tour.
 |-
 |resorts
 |String
-|Идентификаторы курортов, перечисление через запятую.
+|Identifiers of the resorts, enumeration separated by comma.
 |-
 |hotelCategories
 |String
-|Идентификаторы категорий отелей, перечисление через запятую.
+|Identifiers of hotel categories, enumeration separated by comma.
 |-
 |hotels
 |String
-|Идентификаторы отелей,  перечисление через запятую.
+|Hotel identifiers, enumeration separated by comma.
 |-
 |meals
 |String
-|Идентификаторы видов питания, перечисление через запятую.
+|Identifiers of meal options, enumeration separated by comma.
 |-
 |'''currencyId'''
 |Int32
-|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
+|Currency,   which also includes prices, as well as currency for input parameters priceMin and priceMax (if specified).
 |-
 |priceMin
 |Int32
-|Цена тура от.
+|Minimum price of the tour.
 |-
 |priceMax
 |Int32
-|Цена тура до.
+|Maximum price of the tour.
 |-
 |hotelIsNotInStop
 |Int32
-|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
+|If input value equals to 1, the results should not contain any hotels with no places available (hotels with the status «on request» are acceptable).
 |-
 |ticketsIncluded
 |Int32
-|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
+|If input value equals to 1, the results should contain only the tours, for which the flight fare is included into the total price (option only hotel is unacceptable).
 |-
 |hasTickets
 |Int32
-|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
+|If input value equals to 1, the results should contain only the tours, for which the tickets are currently available, there should not be flights with no places available or flights with on request status.
 |-
 |excludeUsualTours

@@ Строка 172: / Строка 172: @@
 The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).
-=== Выгрузка списка валют ===
+=== Returning the List of Currencies ===
-Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.
+This method returns the list of used currencies.  At the very least it has to contain Russian Rubles, US Dollars and Euros.
-'''Формат запроса:''' ?action=GetCurrencies
+'''Format of the query:''' ?action=GetCurrencies
-'''Параметры:'''
+'''Parameters:'''
-* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)
+* id – currency identifier (optional; if specified, only one entry is queried)
-'''Формат выдачи:'''
+'''The output format:'''
   <getCurrenciesResult version="1.0">
@@ Строка 189: / Строка 189: @@
   </getCurrenciesResult>
-Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).
+The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).
 === Поиск туров ===