Справочник методов

Все доступные методы API Жугори, сгруппированные по назначению. Нажмите на метод в боковой панели для быстрого перехода.

Навигация по методам

Сопровождающие методы

Регистрация и управление автомобилями, загрузка фотографий и другие сервисные операции.

POST/api/carmultipart/form-data

Регистрация автомобиля

Регистрация нового автомобиля в системе с фотографиями.

Создаёт запись автомобиля в системе. Фотографии загружаются в том же запросе. Значения для полей car_brand, car_model, type, class, fuel_type, transmission — справочные, их нужно получить заранее.

Предусловия

Партнёр зарегистрирован в системе
Пользователь привязан к партнёру с нужной ролью
Получены справочные значения для марок, моделей, типов кузова, класса, топлива и трансмиссии

Параметры

Параметр	Тип	Обяз.	Описание
car_brand	number	Да	Идентификатор марки автомобиля (справочное значение)
car_model	number	Да	Идентификатор модели автомобиля (справочное значение)
year_of_manufacture	number	Да	Год выпуска автомобиля
type	enum	Да	Тип кузова (справочное значение, например: UNIVERSAL)
class	enum	Да	Класс автомобиля (справочное значение, например: STANDARD)
fuel_type	enum	Да	Тип топлива (справочное значение, например: ELECTRO)
transmission	enum	Да	Трансмиссия (справочное значение, например: AUTOMATIC)
color	string	Да	Цвет автомобиля
photos	file[]	Нет	Фотографии автомобиля. Можно передать несколько файлов, повторяя поле.
door_count	number	Да	Количество дверей
seating_capacity	number	Да	Количество пассажирских мест
luggage_capacity	number	Да	Вместимость багажника (количество мест багажа)
state_number	string	Да	Государственный регистрационный номер
VIN	string	Да	VIN-номер автомобиля

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

cURL

curl --request POST   --url https://api.zhugory.ru/api/car   --header 'Authorization: Bearer SECRET_JWT_TOKEN'   --header 'Content-Type: multipart/form-data'   --form car_brand=6   --form car_model=15   --form year_of_manufacture=2025   --form type=UNIVERSAL   --form class=STANDARD   --form fuel_type=ELECTRO   --form transmission=AUTOMATIC   --form 'color=Белый'   --form 'photos=@/path/to/photo1.jpg'   --form 'photos=@/path/to/photo2.jpg'   --form door_count=5   --form seating_capacity=5   --form luggage_capacity=4   --form state_number=a555aa77   --form VIN=L6T79ZCE1RP159969

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

200 OK

{
  "id": 3,
  "documentId": "szcs67ejmmkobnz898y7dvww",
  "year_of_manufacture": 2025,
  "color": "Белый",
  "type": "UNIVERSAL",
  "door_count": 5,
  "seating_capacity": 5,
  "luggage_capacity": 4,
  "class": "STANDARD",
  "fuel_type": "ELECTRO",
  "transmission": "AUTOMATIC",
  "state_number": "a555aa77",
  "VIN": "L6T79ZCE1RP159969",
  "description": null,
  "createdAt": "2026-08-18T04:39:59.179Z",
  "updatedAt": "2026-08-18T04:40:01.609Z",
  "publishedAt": "2026-08-18T04:40:01.575Z",
  "photos": [
    {
      "id": 11,
      "documentId": "zf1elxlbrkkv5tbh36gwx17j",
      "name": "2026-05-15 11-22-47.JPG",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg",
      "formats": {
        "large":     { "url": "...", "width": 1060, "height": 1500 },
        "medium":    { "url": "...", "width": 389,  "height": 550 },
        "small":     { "url": "...", "width": 208,  "height": 294 },
        "thumbnail": { "url": "...", "width": 50,   "height": 70 },
        "original":  { "url": "...", "width": 2729, "height": 3862 }
      }
    },
    {
      "id": 12,
      "documentId": "eqhs55mgm5b5ndbwyaso6nug",
      "name": "headlights-hood-black-luxury-car.jpg",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
    }
  ],
  "car_brand": {
    "id": 6,
    "documentId": "d8a8gb48ro84ultq88uw0y1i",
    "name": "Zeekr"
  },
  "car_model": {
    "id": 15,
    "documentId": "nhso6qyg8b42j90fohbz5hb3",
    "name": "007"
  }
}

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
400	Неверные или отсутствующие обязательные параметры
403	Пользователь не имеет прав на регистрацию автомобилей

POST/api/car/{documentId}/addPhotosmultipart/form-data

Добавление фотографий к автомобилю

Загрузка дополнительных фотографий для существующего автомобиля.

Добавляет фотографии к ранее зарегистрированному автомобилю. Возвращает обновлённую запись автомобиля со всеми фотографиями (включая ранее загруженные).

Предусловия

Автомобиль зарегистрирован в системе (documentId известен)
Партнёр привязан к этому автомобилю

Параметры

Параметр	Тип	Обяз.	Описание
documentId	string	Да	Идентификатор автомобиля (documentId из ответа при регистрации)
photos	file[]	Да	Фотографии автомобиля. Можно передать несколько файлов, повторяя поле.

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

cURL

curl --request POST   --url https://api.zhugory.ru/api/car/szcs67ejmmkobnz898y7dvww/addPhotos   --header 'Authorization: Bearer SECRET_JWT_TOKEN'   --header 'Content-Type: multipart/form-data'   --form 'photos=@/path/to/photo1.jpg'   --form 'photos=@/path/to/photo2.png'

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

200 OK

{
  "id": 3,
  "documentId": "szcs67ejmmkobnz898y7dvww",
  "year_of_manufacture": 2025,
  "color": "Белый",
  "type": "UNIVERSAL",
  "door_count": 5,
  "seating_capacity": 5,
  "luggage_capacity": 4,
  "class": "STANDARD",
  "fuel_type": "ELECTRO",
  "transmission": "AUTOMATIC",
  "state_number": "a555aa77",
  "VIN": "L6T79ZCE1RP159969",
  "description": null,
  "createdAt": "2026-08-18T04:39:59.179Z",
  "updatedAt": "2026-08-18T05:35:12.618Z",
  "publishedAt": "2026-08-18T05:35:12.597Z",
  "photos": [
    {
      "id": 11,
      "documentId": "zf1elxlbrkkv5tbh36gwx17j",
      "name": "2026-05-15 11-22-47.JPG",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg",
      "formats": {
        "large":     { "url": "...", "width": 1060, "height": 1500 },
        "medium":    { "url": "...", "width": 389,  "height": 550 },
        "small":     { "url": "...", "width": 208,  "height": 294 },
        "thumbnail": { "url": "...", "width": 50,   "height": 70 },
        "original":  { "url": "...", "width": 2729, "height": 3862 }
      }
    },
    {
      "id": 12,
      "documentId": "eqhs55mgm5b5ndbwyaso6nug",
      "name": "headlights-hood-black-luxury-car.jpg",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
    },
    {
      "id": 13,
      "documentId": "uxfb2n42oruov3ho4tp78vqg",
      "name": "2026-05-15 11-22-47.JPG",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
    },
    {
      "id": 14,
      "documentId": "csqr43pqwycil7080ap3ft96",
      "name": "Chevrolet_Tracker_2021_(front)_(cropped).png",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
    }
  ],
  "car_brand": {
    "id": 6,
    "documentId": "d8a8gb48ro84ultq88uw0y1i",
    "name": "Zeekr"
  },
  "car_model": {
    "id": 15,
    "documentId": "nhso6qyg8b42j90fohbz5hb3",
    "name": "007"
  }
}

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
404	Автомобиль с указанным documentId не найден
403	Пользователь не имеет прав на управление этим автомобилем

DELETE/api/car/{carDocumentId}/deletePhoto/{photoDocumentId}

Удаление фотографии автомобиля

Удаление одной из фотографий автомобиля.

Удаляет конкретную фотографию автомобиля. Возвращает обновлённую запись автомобиля без удалённой фотографии.

Предусловия

Автомобиль зарегистрирован в системе (carDocumentId известен)
Идентификатор удаляемой фотографии известен (photoDocumentId из массива photos)

Параметры

Параметр	Тип	Обяз.	Описание
carDocumentId	string	Да	Идентификатор автомобиля (documentId из ответа при регистрации)
photoDocumentId	string	Да	Идентификатор фотографии (documentId из массива photos)

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

cURL

curl --request DELETE   --url https://api.zhugory.ru/api/car/szcs67ejmmkobnz898y7dvww/deletePhoto/uxfb2n42oruov3ho4tp78vqg   --header 'Authorization: Bearer SECRET_JWT_TOKEN'

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

200 OK

{
  "id": 3,
  "documentId": "szcs67ejmmkobnz898y7dvww",
  "year_of_manufacture": 2025,
  "color": "Белый",
  "type": "UNIVERSAL",
  "door_count": 5,
  "seating_capacity": 5,
  "luggage_capacity": 4,
  "class": "STANDARD",
  "fuel_type": "ELECTRO",
  "transmission": "AUTOMATIC",
  "state_number": "a555aa77",
  "VIN": "L6T79ZCE1RP159969",
  "description": null,
  "createdAt": "2026-08-18T04:39:59.179Z",
  "updatedAt": "2026-08-18T05:41:46.693Z",
  "publishedAt": "2026-08-18T05:41:46.681Z",
  "photos": [
    {
      "id": 12,
      "documentId": "eqhs55mgm5b5ndbwyaso6nug",
      "name": "headlights-hood-black-luxury-car.jpg",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
    },
    {
      "id": 14,
      "documentId": "csqr43pqwycil7080ap3ft96",
      "name": "Chevrolet_Tracker_2021_(front)_(cropped).png",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
    }
  ],
  "car_brand": {
    "id": 6,
    "documentId": "d8a8gb48ro84ultq88uw0y1i",
    "name": "Zeekr"
  },
  "car_model": {
    "id": 15,
    "documentId": "nhso6qyg8b42j90fohbz5hb3",
    "name": "007"
  }
}

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
404	Автомобиль или фотография с указанным идентификатором не найдены
403	Пользователь не имеет прав на управление этим автомобилем

GET/api/partner/getMyEmployeeCars

Получение списка автомобилей компании

Возвращает список всех автомобилей компании, в которой работает пользователь.

Возвращает все автомобили, зарегистрированные в компании (автопарке) текущего пользователя. Список включает полную информацию об автомобилях и их фотографиях.

Предусловия

Пользователь привязан к партнёру (компании) с нужной ролью

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

cURL

curl --request GET   --url https://api.zhugory.ru/api/partner/getMyEmployeeCars   --header 'Authorization: Bearer SECRET_JWT_TOKEN'

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

200 OK

[
  {
    "id": 1,
    "documentId": "e7b7ysss47f1fzashz4xqnd8",
    "year_of_manufacture": 2025,
    "color": "whyte",
    "type": "SUV",
    "door_count": 5,
    "seating_capacity": 5,
    "luggage_capacity": 3,
    "class": "PREMIUM",
    "fuel_type": "ELECTRO",
    "transmission": "AUTOMATIC",
    "state_number": "A345TO777",
    "VIN": "23344FFGGHHYTTTR4",
    "description": "supercar need now",
    "createdAt": "2026-07-08T06:11:41.737Z",
    "updatedAt": "2026-07-27T03:19:50.141Z",
    "publishedAt": "2026-07-27T03:19:50.066Z",
    "locale": null,
    "photos": [
      {
        "id": 1,
        "documentId": "duanqwyra7t2gzma40y25axw",
        "name": "photo_0.jpg",
        "mime": "image/jpeg",
        "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg",
        "formats": {
          "large":     { "url": "...", "width": 1125, "height": 1500 },
          "medium":    { "url": "...", "width": 412,  "height": 550 },
          "small":     { "url": "...", "width": 220,  "height": 294 },
          "thumbnail": { "url": "...", "width": 53,   "height": 70 },
          "original":  { "url": "...", "width": 3456, "height": 4608 }
        }
      }
    ],
    "car_model": { "id": 14, "documentId": "xumg9wagxottoygpuvo9ldhd", "name": "001" },
    "car_brand": { "id": 6,  "documentId": "d8a8gb48ro84ultq88uw0y1i", "name": "Zeekr" }
  },
  {
    "id": 2,
    "documentId": "pdf4qg6q0u0msmtfsydxopyv",
    "year_of_manufacture": 2010,
    "color": "yellow",
    "type": "SUV",
    "door_count": 5,
    "seating_capacity": 4,
    "luggage_capacity": 4,
    "class": "PREMIUM",
    "fuel_type": "EURO-5",
    "transmission": "MANUAL",
    "state_number": "B888TU545",
    "VIN": "ERTWEFLFKFKFITI77",
    "description": "new and luxury",
    "createdAt": "2026-07-08T06:13:24.207Z",
    "updatedAt": "2026-07-30T12:07:28.442Z",
    "publishedAt": "2026-07-30T12:07:28.421Z",
    "locale": null,
    "photos": [
      {
        "id": 3,
        "documentId": "z4iore81o62fpb1w4n3u3ioj",
        "name": "photo_0.jpg",
        "mime": "image/jpeg",
        "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
      },
      {
        "id": 4,
        "documentId": "bif6hoj9you6h9ei4s3ojhto",
        "name": "photo_1.jpg",
        "mime": "image/jpeg",
        "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
      }
    ],
    "car_model": { "id": 7,  "documentId": "wkyk6ewaia89isjea14w6p2g", "name": "GLE" },
    "car_brand": { "id": 1,  "documentId": "mumtwdhy33hfu7h73vuyupiy", "name": "Mercedes" }
  },
  {
    "id": 3,
    "documentId": "szcs67ejmmkobnz898y7dvww",
    "year_of_manufacture": 2025,
    "color": "Белый",
    "type": "UNIVERSAL",
    "door_count": 5,
    "seating_capacity": 5,
    "luggage_capacity": 4,
    "class": "STANDARD",
    "fuel_type": "ELECTRO",
    "transmission": "AUTOMATIC",
    "state_number": "a555aa77",
    "VIN": "L6T79ZCE1RP159969",
    "description": null,
    "createdAt": "2026-08-18T04:39:59.179Z",
    "updatedAt": "2026-08-18T05:41:46.693Z",
    "publishedAt": "2026-08-18T05:41:46.681Z",
    "locale": null,
    "photos": [
      {
        "id": 12,
        "documentId": "eqhs55mgm5b5ndbwyaso6nug",
        "name": "headlights-hood-black-luxury-car.jpg",
        "mime": "image/jpeg",
        "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
      },
      {
        "id": 14,
        "documentId": "csqr43pqwycil7080ap3ft96",
        "name": "Chevrolet_Tracker_2021_(front)_(cropped).png",
        "mime": "image/jpeg",
        "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
      }
    ],
    "car_model": { "id": 15, "documentId": "nhso6qyg8b42j90fohbz5hb3", "name": "007" },
    "car_brand": { "id": 6,  "documentId": "d8a8gb48ro84ultq88uw0y1i", "name": "Zeekr" }
  }
]

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
403	Пользователь не привязан к компании-партнёру

GET/api/car/{documentId}

Получение подробной информации об автомобиле

Возвращает подробную информацию о выбранном автомобиле.

Возвращает полную информацию об автомобиле по его documentId, включая фотографии, марку и модель.

Предусловия

documentId автомобиля известен (например, из списка автомобилей компании)

Параметры

Параметр	Тип	Обяз.	Описание
documentId	string	Да	Идентификатор автомобиля (documentId из ответа при регистрации)

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

cURL

curl --request GET   --url https://api.zhugory.ru/api/car/szcs67ejmmkobnz898y7dvww   --header 'Authorization: Bearer SECRET_JWT_TOKEN'

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

200 OK

{
  "id": 3,
  "documentId": "szcs67ejmmkobnz898y7dvww",
  "year_of_manufacture": 2025,
  "color": "Белый",
  "type": "UNIVERSAL",
  "door_count": 5,
  "seating_capacity": 5,
  "luggage_capacity": 4,
  "class": "STANDARD",
  "fuel_type": "ELECTRO",
  "transmission": "AUTOMATIC",
  "state_number": "a555aa77",
  "VIN": "L6T79ZCE1RP159969",
  "description": null,
  "createdAt": "2026-08-18T04:39:59.179Z",
  "updatedAt": "2026-08-18T05:41:46.693Z",
  "publishedAt": "2026-08-18T05:41:46.681Z",
  "locale": null,
  "car_brand": {
    "id": 6,
    "documentId": "d8a8gb48ro84ultq88uw0y1i",
    "name": "Zeekr"
  },
  "car_model": {
    "id": 15,
    "documentId": "nhso6qyg8b42j90fohbz5hb3",
    "name": "007"
  },
  "photos": [
    {
      "id": 12,
      "documentId": "eqhs55mgm5b5ndbwyaso6nug",
      "name": "headlights-hood-black-luxury-car.jpg",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg",
      "formats": {
        "large":     { "url": "...", "width": 1500, "height": 1001 },
        "medium":    { "url": "...", "width": 550,  "height": 367 },
        "small":     { "url": "...", "width": 294,  "height": 196 },
        "thumbnail": { "url": "...", "width": 70,   "height": 47 },
        "original":  { "url": "...", "width": 4000, "height": 2669 }
      }
    },
    {
      "id": 14,
      "documentId": "csqr43pqwycil7080ap3ft96",
      "name": "Chevrolet_Tracker_2021_(front)_(cropped).png",
      "mime": "image/jpeg",
      "url": "https://s3.ru1.storage.beget.cloud/.../original.jpg"
    }
  ]
}

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
404	Автомобиль с указанным documentId не найден
403	Пользователь не имеет прав на просмотр этого автомобиля

GET/api/partner/getMyPickupOffices

Получение списка офисов сдачи/выдачи автомобилей

Возвращает список офисов (точек выдачи и возврата) арендной компании.

Возвращает все офисы сдачи/выдачи автомобилей, принадлежащие компании текущего пользователя. Офисы используются при оформлении бронирования.

Предусловия

Пользователь привязан к партнёру (компании) с нужной ролью
Офисы сдачи/выдачи настроены для компании

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

cURL

curl --request GET   --url https://api.zhugory.ru/api/partner/getMyPickupOffices   --header 'Authorization: Bearer SECRET_JWT_TOKEN'

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

200 OK

[
  {
    "id": 1,
    "documentId": "hkraiqeh05ofko76p74hsjen",
    "title": "Шереметьево",
    "description": "Терминал С, слева от входа 2",
    "full_address": "Москва, Шереметьево",
    "lat": "55.4444",
    "lon": "37.55555",
    "createdAt": "2026-02-08T19:06:36.470Z",
    "updatedAt": "2026-02-08T19:06:36.470Z",
    "publishedAt": "2026-02-08T19:06:36.460Z",
    "locale": null
  },
  {
    "id": 2,
    "documentId": "t08leas85mvkfdmutf97veg5",
    "title": "Домодедово",
    "description": "Выход А",
    "full_address": "Москва, Домодедово, взлётная",
    "lat": "55.4444",
    "lon": "37.55555",
    "createdAt": "2026-02-09T03:46:13.415Z",
    "updatedAt": "2026-02-09T03:46:13.415Z",
    "publishedAt": "2026-02-09T03:46:13.408Z",
    "locale": null
  },
  {
    "id": 3,
    "documentId": "twdtrsx4xms67dz374sv8zjv",
    "title": "Екатеринбург-Центр",
    "description": "Круглосуточная выдача",
    "full_address": "Екатеринбург, ул. Малышева, д. 51",
    "lat": "56.838011",
    "lon": "60.597465",
    "createdAt": "2026-02-09T03:49:55.754Z",
    "updatedAt": "2026-02-09T03:49:55.754Z",
    "publishedAt": "2026-02-09T03:49:55.750Z",
    "locale": null
  }
]

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
403	Пользователь не привязан к компании-партнёру

GET/api/partner/getTransferConditionsChecklist

Получение списка пунктов акта приёма-передачи

Возвращает чек-лист пунктов осмотра автомобиля для акта приёма-передачи.

Возвращает справочник пунктов проверки автомобиля, сгруппированных по категориям: внешнее состояние, внутреннее состояние и техническое состояние. Список пунктов формируется техподдержкой и редактируется по запросу.

Предусловия

Пользователь привязан к партнёру (компании) с нужной ролью

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

cURL

curl --request GET   --url https://api.zhugory.ru/api/partner/getTransferConditionsChecklist   --header 'Authorization: Bearer SECRET_JWT_TOKEN'

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

200 OK

{
  "external_conditions": [
    {
      "documentId": "omi17s7mlp9ljhiw5ijkxz4i",
      "description": "Кузов без вмятин, сколов и коррозии",
      "category_name": "Внешнее состояние",
      "category": "EXTERNAL"
    },
    {
      "documentId": "dw9dqo76h4r780ugp1ne2rer",
      "description": "Все фары, поворотники и стоп-сигналы исправны",
      "category_name": "Внешнее состояние",
      "category": "EXTERNAL"
    },
    {
      "documentId": "t5u8zyax9x96swm65sgeuf91",
      "description": "Давление в шинах в норме, протектор не изношен",
      "category_name": "Внешнее состояние",
      "category": "EXTERNAL"
    },
    {
      "documentId": "jfjo8zdk066cinv3b1wx5plo",
      "description": "Стеклоочистители работают, омывайка залита",
      "category_name": "Внешнее состояние",
      "category": "EXTERNAL"
    },
    {
      "documentId": "wd9drsumwj4ebutiva7m81w4",
      "description": "Зеркала заднего вида целы и отрегулированы",
      "category_name": "Внешнее состояние",
      "category": "EXTERNAL"
    }
  ],
  "internal_conditions": [
    {
      "documentId": "hofld07o5nl5haniu0bsk8z3",
      "description": "Чистый салон, никакого мусора и посторонних запахов",
      "category_name": "Внутреннее состояние",
      "category": "INTERNAL"
    },
    {
      "documentId": "p8d7jmjus3scy4egjrwxl291",
      "description": "Ремни безопасности исправны и легко застегиваются",
      "category_name": "Внутреннее состояние",
      "category": "INTERNAL"
    },
    {
      "documentId": "dinflv9f9x0nq6a84krhszma",
      "description": "Климат / кондиционер работают корректно",
      "category_name": "Внутреннее состояние",
      "category": "INTERNAL"
    },
    {
      "documentId": "cddvvhpjcu586kmfqk4u6c2k",
      "description": "Стеклоподъемники и центральный замок в порядке",
      "category_name": "Внутреннее состояние",
      "category": "INTERNAL"
    },
    {
      "documentId": "vy253zniue0b2m23r13i4441",
      "description": "Мультимедиа / зарядки для телефона работают",
      "category_name": "Внутреннее состояние",
      "category": "INTERNAL"
    }
  ],
  "tech_conditions": [
    {
      "documentId": "kglvs0hgotuydroen47idtoq",
      "description": "Нет критических ошибок на приборной панели (Check Engine, ABS и т.д.)",
      "category_name": "Техническое состояние",
      "category": "TECH"
    },
    {
      "documentId": "dt9n4spfvrumnh2zrgn31hft",
      "description": "Уровень масла, тормозной жидкости и антифриза в норме",
      "category_name": "Техническое состояние",
      "category": "TECH"
    },
    {
      "documentId": "v5ssm6tdnldo0rsoz6hddz8z",
      "description": "Тормозная система исправна (педаль не проваливается)",
      "category_name": "Техническое состояние",
      "category": "TECH"
    },
    {
      "documentId": "rarnbtqf6zxxs95n2illakhw",
      "description": "Аккумулятор заряжен, стартер крутит бодро",
      "category_name": "Техническое состояние",
      "category": "TECH"
    },
    {
      "documentId": "kz0anew33egq5z92w9zictp2",
      "description": "Рулевое управление без люфтов и посторонних звуков",
      "category_name": "Техническое состояние",
      "category": "TECH"
    }
  ]
}

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
403	Пользователь не привязан к компании-партнёру

Бизнесовые методы

Работа с заявками: приём, подтверждение и отказ бронирования, подписание актов, назначение штрафов.

GET/api/car-rental-request

Получение списка запросов на аренду

Возвращает список запросов от клиентов на получение предложений с ценой аренды автомобилей.

Возвращает все запросы клиентов, направленные партнёру. Пользователи опрашивают арендные компании: кто и за сколько предложит свой автомобиль на нужный маршрут. Каждый запрос содержит маршрут (начальный и конечный город), даты аренды, статус и количество ответов партнёров.

Предусловия

Пользователь привязан к партнёру (компании) с нужной ролью

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

cURL

curl --request GET   --url https://api.zhugory.ru/api/car-rental-request   --header 'Authorization: Bearer SECRET_JWT_TOKEN'

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

200 OK

[
  {
    "documentId": "p7j4nvnn3snsnvyrpjrme7ge",
    "request_status": "DELIVERED",
    "sent_at": "2026-08-15T07:59:02.809Z",
    "is_car_rental_response_sent": false,
    "start_city": {
      "id": 1,
      "documentId": "de2xcsdgangdm8s7p17ytej0",
      "city": "Москва",
      "region": "Москва"
    },
    "inter_city": {
      "id": 4,
      "documentId": "jbald3rmm8e1huil8gcndbw4",
      "city": "Казань",
      "region": "Татарстан"
    },
    "start_date_local": "2026-10-14T21:00:00",
    "end_date_local": "2026-10-21T18:00:00",
    "car_rental_responses_count": 1
  }
]

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
403	Пользователь не привязан к компании-партнёру

GET/api/car-rental-request/{documentId}

Получение подробной информации о запросе на аренду

Возвращает подробную информацию о запросе клиента на предложение с ценой аренды.

Возвращает полную информацию о запросе клиента: маршрут, даты в локальном и UTC форматах, сведения об инициаторе и сменщике, комментарии. Примечание: на этом этапе данные пользователей маскируются — персональная информация скрывается (возраст, часть ФИО, место рождения). Полные данные становятся доступны партнёру после подтверждения бронирования.

Предусловия

documentId запроса известен (например, из списка запросов на аренду)

Параметры

Параметр	Тип	Обяз.	Описание
documentId	string	Да	Идентификатор запроса на аренду (documentId из списка запросов)

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

cURL

curl --request GET   --url https://api.zhugory.ru/api/car-rental-request/p7j4nvnn3snsnvyrpjrme7ge   --header 'Authorization: Bearer SECRET_JWT_TOKEN'

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

200 OK

{
  "documentId": "p7j4nvnn3snsnvyrpjrme7ge",
  "request_status": "DELIVERED",
  "sent_at": "2026-08-15T07:59:02.809Z",
  "is_car_rental_response_sent": false,
  "start_city": {
    "id": 1,
    "documentId": "de2xcsdgangdm8s7p17ytej0",
    "city": "Москва",
    "region": "Москва"
  },
  "inter_city": {
    "id": 4,
    "documentId": "jbald3rmm8e1huil8gcndbw4",
    "city": "Казань",
    "region": "Татарстан"
  },
  "start_date_local": "2026-10-14T21:00:00",
  "start_date_utc": "2026-10-14T18:00:00.000Z",
  "inter_date_local": "2026-10-17T21:00:00",
  "inter_date_utc": "2026-10-17T18:00:00.000Z",
  "end_date_local": "2026-10-21T18:00:00",
  "end_date_utc": "2026-10-21T15:00:00.000Z",
  "initiator": {
    "id": 8,
    "documentId": "efc0nsuf1xw3nrp28l0pcom0",
    "username": "79039617601",
    "user_masked_data": {
      "age": 44,
      "full_name": "Арина Р.",
      "passport_birth_place": "Istambul"
    }
  },
  "changer": {
    "id": 2,
    "documentId": "arp34bqawdograw5bo4o5n1g",
    "username": "79857619905",
    "user_masked_data": {
      "age": 47,
      "full_name": "Джон Н.",
      "passport_birth_place": "г. Челябинск"
    }
  },
  "comment_initiator": "Test comment from initiator",
  "comment_changer": "Test comment from changer",
  "car_rental_responses_count": 1
}

Возможные ошибки

Код	Описание
401	Неверный или отсутствующий JWT-токен
404	Запрос с указанным documentId не найден
403	Пользователь не имеет прав на просмотр этого запроса

POST/api/car-rental-response/{carRentalRequestDocumentId}application/json

Регистрация предложения с ценой аренды

Партнёр отправляет предложение с ценой на аренду автомобиля в ответ на запрос клиента.

Создаёт предложение (отклик) партнёра на запрос клиента. Партнёр указывает автомобиль, цену, депозит, офисы выдачи, включённые услуги, преимущества и штрафы за перепробег. Страхование — обязательно, один из трёх взаимоисключающих режимов: • Режим A — индивидуальные страховые полисы от страховой компании на каждого участника (insurance_options_initiator + insurance_options_changer, с указанием ИНН страховой компании и дат действия) • Режим B — страховка включена в стоимость аренды (service_included_insurance_document_id) • Режим C — общая страховка на обоих пользователей (shared_insurance_document_id + shared_insurance_price) Нельзя отправить два предложения на один и тот же автомобиль в рамках одного запроса.

Предусловия

Партнёр получил запрос на аренду (carRentalRequestDocumentId известен)
Автомобиль зарегистрирован и принадлежит компании партнёра
Получены documentId офисов сдачи/выдачи
Выбран и согласован один из трёх режимов страхования

Параметры

Параметр	Тип	Обяз.	Описание
carRentalRequestDocumentId	string	Да	Идентификатор запроса на аренду (documentId из списка запросов)
car_document_id	string	Да	Идентификатор автомобиля (documentId из списка автомобилей компании)
service_price	number	Да	Стоимость аренды автомобиля
deposite	number	Да	Размер депозита
valid_until	string (ISO 8601)	Нет	Срок действия предложения. Если не указан — бессрочно.
pickup_points	string[]	Да	Массив documentId офисов сдачи/выдачи (хотя бы один). Получаются через метод получения списка офисов.
service_included_insurance_document_id	string	Нет	Режим B: страховка включена в стоимость. documentId страхового продукта. Взаимоисключающ с другими режимами.
shared_insurance_document_id	string	Нет	Режим C: общая страховка на обоих пользователей. documentId страхового продукта. Взаимоисключающ с другими режимами.
shared_insurance_price	number	Нет	Режим C: стоимость общей страховки. Обязателен при использовании shared_insurance_document_id.
insurance_options_initiator	object[]	Нет	Режим A: индивидуальные полисы для инициатора. Каждый элемент: { insurance_company_tin, insurance_date_from, insurance_date_to }. Взаимоисключающ с другими режимами.
insurance_options_changer	object[]	Нет	Режим A: индивидуальные полисы для сменщика. Каждый элемент: { insurance_company_tin, insurance_date_from, insurance_date_to }. Взаимоисключающ с другими режимами.
included_services	object[]	Нет	Включённые услуги. Каждый элемент: { name: string, description?: string }.
benefits	(string\|object)[]	Нет	Преимущества предложения. Строки или объекты { name: string }.
top_label	string	Нет	Метка-ярлык для предложения (например, «Рекомендуем»)
overrun_penalty	object	Нет	Штраф за перепробег: { daily_limit: number, overrun_penalty_per_km: number }

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

cURL

curl --request POST   --url https://api.zhugory.ru/api/car-rental-response/gcvcb6bkfn8lt6iqu0gxjqdq   --header 'Authorization: Bearer SECRET_JWT_TOKEN'   --header 'Content-Type: application/json'   --data '{
  "car_document_id": "z92n4s1jetqmeueh36oph55k",
  "service_price": 10000,
  "deposite": 10000,
  "valid_until": "2026-07-20T10:00:00.000Z",
  "service_included_insurance_document_id": "zak97t12e9yz7twqj98ab3ut",
  "pickup_points": [
    "cv26a6g3xdzeo66exjjin3ia",
    "oh3w2ygxp38o0qwadxj4fcfv",
    "is6b1qb8b2sa20jsdqv26mc4"
  ],
  "included_services": [
    { "name": "Навигатор", "description": "Какое-то описание" },
    { "name": "Транспондер", "description": "Какое-то описание" },
    { "name": "Помощь на дороге", "description": "Какое-то описание" }
  ],
  "benefits": [
    "Полбака в дорогу",
    "Нет штрафа за перепробег"
  ],
  "top_label": "Рекомендуем",
  "overrun_penalty": {
    "daily_limit": 300,
    "overrun_penalty_per_km": 10
  }
}'

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

200 OK

{
  "success": true
}

Возможные ошибки

Код	Описание
400	Ошибка валидации: отсутствуют или неверные обязательные поля
401	Неверный или отсутствующий JWT-токен
403	Пользователь не привязан к компании-партнёру
404	Запрос на аренду не найден
409	Предложение для этого автомобиля уже существует в рамках данного запроса

POST/api/requests/{requestId}/confirm

Подтверждение бронирования

Подтверждение бронирования после приёма заявки.

Параметры, примеры запросов и ответов будут добавлены позднее.

POST/api/requests/{requestId}/reject

Отказ от бронирования

Отказ в бронировании с указанием причины.

Параметры, примеры запросов и ответов будут добавлены позднее.

POST/api/requests/{requestId}/sign-act

Подписание акта приёма-передачи

Подписание электронного акта приёма-передачи автомобиля.

Параметры, примеры запросов и ответов будут добавлены позднее.

POST/api/requests/{requestId}/penalties

Назначение штрафа

Назначение штрафа пользователю за нарушение условий аренды.

Параметры, примеры запросов и ответов будут добавлены позднее.

События вебхуков

Жугори отправляет эти события POST-запросом на URL партнёра или письмом на email. Тело запроса и список параметров настраиваются с каждым партнёром индивидуально в соответствии с его требованиями — структура согласовывается с техподдержкой при подключении.

POSTrequest-created

Новая заявка

Пользователь оставил заявку на аренду автомобиля. Это начальное событие бизнес-процесса.

Тело запроса и список параметров настраиваются с каждым партнёром индивидуально в соответствии с его требованиями.

POSTrequest-cancelled

Заявка отменена пользователем

Пользователь отменил свою заявку до подтверждения бронирования.

POSTbooking-confirmed

Бронирование подтверждено

Бронирование подтверждено партнёром (или автоматически). Начинается этап выдачи автомобиля.

POSTbooking-rejected

Бронирование отклонено

Партнёр отклонил бронирование с указанием причины.

POSTact-signed

Акт приёма-передачи подписан

Электронный акт приёма-передачи подписан одной из сторон.

POSTrental-completed

Аренда завершена

Аренда автомобиля завершена — автомобиль возвращён.

Не нашли нужный метод или нужна помощь с интеграцией?

Связаться с техподдержкой