Условия почасовой аренды
Общие сведения
С помощью этого метода можно:
- Определить возможность оказания услуги "Почасовая аренда" для определенного города;
- Получить список доступных для заказа транспортных средств;
- Получить информацию о доступных услугах и их стоимости в разрезе транспортных средств.
Если необходимо получить полную информацию по всем городам, где предоставляется услуга "Почасовая аренда", следует воспользоваться справочником "Информация для заказа почасовой аренды".
Условия почасовой аренды
Запрос метода
Пример запроса
Адрес метода: https://api.dellin.ru/v1/public/request_hr_info.json
{ "appkey": "00000000-0000-0000-0000-000000000000", "city": "7800000000000000000000000" }
Адрес метода: https://api.dellin.ru/v1/public/request_hr_info.xml
<request> <appkey>00000000-0000-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_types | array of Response.Car_types | Типы автомобилей |
Response.Car_types | ||
---|---|---|
Параметр | Тип | Описание |
id | integer | ID транспортного средства. Это значение нужно передавать в параметре "carType" метода "Заявка на почасовую аренду" |
city | string | Город |
category | string | Название транспортного средства |
timeMinimum | integer | Минимальное время заказа машины, час |
timeToDelivery | integer | Время подачи машины, час |
hourlyPrice | integer | Стоимость аренды, руб/час |
outerDistancePrice | float | Стоимость аренды за городом, руб/км |
manipulator | boolean | Признак доступности заказа услуги "Манипулятор" |
manipulator_price | integer | Стоимость заказа услуги "Манипулятор", руб. Если услуга недоступна, то значение параметра равно "0" |
removeCover | boolean | Признак доступности заказа услуги "Растентовка" |
removeCoverPrice | integer | Стоимость заказа услуги "Растентовка", руб. Если услуга недоступна, то значение параметра равно "0" |
toCenter | boolean | Признак изменения стоимости аренды при заезде в центр города |
toCenterPrice | integer | Стоимость аренды при заезде в центр города, руб/час. Если стоимость не меняется, то значение параметра равно "0" |
tonnage* | integer | Грузоподъемность, кг |
float | Высота, м |
*Для некоторых видов машин значение этого параметра может быть не определено. В этом случае параметр принимает значение "0".
Обработка ошибок
Пример ответа
{ "answer":{ "state":"error", "errors":{ "city":"Указан некорректный код КЛАДР" } } }
<response> <answer> <state>error</state> <errors> <city>Указан некорректный код КЛАДР</city> </errors> </answer> </response>
Виды ошибок
Ошибка | Описание |
---|---|
Указан некорректный код КЛАДР | Код КЛАДР, переданный в параметре "city", отсутствует в "Справочнике населенных пунктов" |
В указанном городе услуга не предоставляется | В городе, код КЛАДР которого передан в параметре "city", услуга не предоставляется |