Поиск по сайту

API
Главная / API - Условия почасовой аренды

Условия почасовой аренды

Обновлено 09.08.2017
76 кб

Общая информация 

С помощью этого метода можно:

  1. Определить возможность оказания услуги "Почасовая аренда" для определенного города; 
  2. Получить список доступных для заказа транспортных средств;
  3. Получить информацию о доступных услугах и их стоимости в разрезе транспортных средств.

Если необходимо получить полную информацию по всем городам, где предоставляется услуга "Почасовая аренда", следует воспользоваться справочником "Информация для заказа почасовой аренды". 

Условия почасовой аренды

Запрос метода

Пример запроса 

Адрес метода: https://api.dellin.ru/v1/public/request_hr_info.json

{
   "appkey": "00000000-0000-0000-000000000000",
   "city": "7800000000000000000000000"
}

Адрес метода: https://api.dellin.ru/v1/public/request_hr_info.xml

<request>
   <appkey>00000000-0000-0000-000000000000</appkey>
   <city>7800000000000000000000000</city>
</request>

Описание параметров

Request
ПараметрR*ТипОписание
appkeyДаstringКлюч приложения. Для получения ключа необходимо пройти регистрацию
cityДаstringКЛАДР города. Может быть получен из "Справочника населенных пунктов"

Ответ метода 

Пример ответа

{  
   "car_types":[  
      {  
         "time_to_delivery":1,
         "remove_cover_price":500,
         "to_center_price":0,
         "time_minimum":4,
         "height":1.95,
         "volume":15,
         "tonnage":2000,
         "to_center":false,
         "outer_distance_price":17,
         "remove_cover":true,
         "id":98,
         "manipulator_price":0,
         "category":"Тент/Фургон",
         "city":"Санкт-Петербург",
         "manipulator":false,
         "hourly_price":600,
         "width":2,
         "length":4
      },
      {  
         "time_to_delivery":1,
         "remove_cover_price":0,
         "to_center_price":0,
         "time_minimum":5,
         "height":2.1000000000000001,
         "volume":17,
         "tonnage":3000,
         "to_center":false,
         "outer_distance_price":23,
         "remove_cover":false,
         "id":143,
         "manipulator_price":0,
         "category":"Фургон",
         "city":"Санкт-Петербург",
         "manipulator":false,
         "hourly_price":650,
         "width":2.1000000000000001,
         "length":4
      }
   ]
}
<response>
   <car_types>
      <category>Тент/Фургон</category>
      <city>Санкт-Петербург</city>
      <height>1.95</height>
      <hourly_price>600</hourly_price>
      <id>98</id>
      <length>4.0</length>
      <manipulator>False</manipulator>
      <manipulator_price>0</manipulator_price>
      <outer_distance_price>17.0</outer_distance_price>
      <remove_cover>True</remove_cover>
      <remove_cover_price>500</remove_cover_price>
      <time_minimum>4</time_minimum>
      <time_to_delivery>1</time_to_delivery>
      <to_center>False</to_center>
      <to_center_price>0</to_center_price>
      <tonnage>2000</tonnage>
      <volume>15.0</volume>
      <width>2.0</width>
   </car_types>
   <car_types>
      <category>Фургон</category>
      <city>Санкт-Петербург</city>
      <height>2.1</height>
      <hourly_price>650</hourly_price>
      <id>143</id>
      <length>4.0</length>
      <manipulator>False</manipulator>
      <manipulator_price>0</manipulator_price>
      <outer_distance_price>23.0</outer_distance_price>
      <remove_cover>False</remove_cover>
      <remove_cover_price>0</remove_cover_price>
      <time_minimum>5</time_minimum>
      <time_to_delivery>1</time_to_delivery>
      <to_center>False</to_center>
      <to_center_price>0</to_center_price>
      <tonnage>3000</tonnage>
      <volume>17.0</volume>
      <width>2.1</width>
   </car_types>
</response>

Описание параметров

Response
ПараметрТипОписание
car_typesarray of Response.Car_typesТипы автомобилей

Response.Car_types
ПараметрТипОписание
idintegerID транспортного средства. Это значение нужно передавать в параметре "carType" метода "Заявка на почасовую аренду"
citystringГород
categorystringНазвание транспортного средства
timeMinimumintegerМинимальное время заказа машины, час
timeToDeliveryintegerВремя подачи машины, час
hourlyPriceintegerСтоимость аренды, руб/час
outerDistancePricefloatСтоимость аренды за городом, руб/км
manipulatorboolean

Признак доступности заказа услуги "Манипулятор"

manipulator_priceintegerСтоимость заказа услуги "Манипулятор", руб. Если услуга недоступна, то значение параметра равно "0"
removeCoverbooleanПризнак доступности заказа услуги "Растентовка"
removeCoverPriceintegerСтоимость заказа услуги "Растентовка", руб. Если услуга недоступна, то значение параметра равно "0"
toCenterbooleanПризнак изменения стоимости аренды при заезде в центр города
toCenterPriceintegerСтоимость аренды при заезде в центр города, руб/час. Если стоимость не меняется, то значение параметра равно "0"
tonnage*integerГрузоподъемность, кг
volume*floatОбъём, куб. м
length*floatДлина, м
width*floatШирина, м
height*floatВысота, м
*Для некоторых видов машин значение этого параметра может быть не определено. В этом случае параметр принимает значение "0".

Обработка ошибок

Пример ответа

{  
   "answer":{  
      "state":"error",
      "errors":{  
         "city":"Указан некорректный код КЛАДР"
      }
   }
}
<response>
   <answer>
      <state>error</state>
      <errors>
         <city>Указан некорректный код КЛАДР</city>
      </errors>
   </answer>
</response>

Виды ошибок

ОшибкаОписание
Указан некорректный код КЛАДРКод КЛАДР, переданный в параметре "city", отсутствует в "Справочнике населенных пунктов"
В указанном городе услуга не предоставляетсяФормат параметра: 11 цифр с ведущей семеркой (79999999999)