Начало
API
Продукты/Сервисы

Продукты/Сервисы

Метод products

Вы можете получить информация о продуктах по методу products

  • URL: https://api.host.gokarvon.com/v1/products
  • Метод: GET
  • Параметры: Нет
  • Content-Type: application/json
ℹ️
products возвращает 20 последних продуктов

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

{
    "data": {
        "products": [
            {
                // Информация о продукте
            }
        ]
    }
}

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

Параметр Описание
products Массив продуктов

Метод products/{id}

Вы можете получить информацию о конкретном продукте по методу products/{id}

  • URL: https://api.host.gokarvon.com/v1/products/{id}
  • Метод: GET
  • Параметры: ID продукта
  • Content-Type: application/json

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

{
    "data": {
        "category": 12,
        "createdAt": "2025-03-01T13:49:09.16488Z",
        "description": "Karvon Test",
        "duration": {
            "duration": null,
            "durationType": 0,
            "durationUnit": 1,
            "maxDuration": 5,
            "maxDurationUnit": 1,
            "minDuration": 15,
            "minDurationUnit": 0,
            "timeBlock": 15,
            "timeBlockDurationUnit": 0
        },
        "id": "23d89adc-cd1a-437b-a1e0-2867e897bbf0",
        "locationType": 0,
        "maxClients": 40,
        "maxClientsPerOrder": 4,
        "maxOrders": 10,
        "minClientsPerOrder": 1,
        "name": "Столик на балконе",
        "partnerId": "5ioGXTaq1jXOxwB7F7yKTFAxTmn2",
        "paymentModes": [
            1
        ],
        "photos": [],
        "pricing": {
            "deposit": 0,
            "depositCurrency": 0,
            "latePaymentPercentage": 0,
            "prepaymentPercentage": 0,
            "price": 0,
            "priceCurrency": 0,
            "priceDuration": null,
            "priceTimeUnit": null,
            "pricingMode": 0
        },
        "rules": {
            "gracePeriod": null,
            "minAge": null,
            "rules": null
        }
    },
    "error": 0
}

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

Параметр Тип данных JSON Описание
category number int Категория продукта
createdAt string Дата создания
description string Описание продукта
duration object Длительность
id string ID продукта
locationType number int Тип выбора локации
maxClients number int Максимальное количество клиентов в данный момент
maxClientsPerOrder number int Максимальное количество клиентов / заказ
maxOrders number int Максимальное количество заказов в данный момент
minClientsPerOrder number int Минимальное количество клиентов / заказ
name string Название продукта
partnerId string ID партнера
paymentModes array Способы оплаты
photos array Фотографии
pricing object Цены
rules object Правила

Категории продуктов

Категория Описание Название в системе Karvon
0 Другое OTHER
1 Аренда спортивного оборудования SPORTS_LOCATION_RENTAL
2 Аренда места для мероприятий EVENT_LOCATION_RENTAL
3 Аренда жилья HOUSING_RENTAL
4 Аренда автомобиля CAR_RENTAL
5 Аренда фотостудии PHOTO_STUDIO_RENTAL
6 Аренда оборудования EQUIPMENT_RENTAL
7 Услуги парикмахера BARBER_SERVICE
8 Услуги репетитора TUTOR_SERVICE
9 Игры на ПК PC_GAMING
10 Игры на консолях CONSOLE_GAMING
11 Аренда игровой кабины GAMING_CABIN_RENTAL
12 Ресторан RESTAURANT
13 Частный ужин PRIVATE_DINING
14 Организация мероприятий EVENT_ORGANIZATION

Параметры duration

Параметр Тип данных JSON Описание
duration number int Длительность
durationType number int Тип длительности
durationUnit number int Единица длительности
maxDuration number int Максимальная длительность
maxDurationUnit number int Единица максимальной длительности
minDuration number int Минимальная длительность
minDurationUnit number int Единица минимальной длительности
timeBlock number int Временной блок
timeBlockDurationUnit number int Единица временного блока
Типы длительности
Тип Описание Название в системе Karvon
0 Клиент выбирает длительность заказа CLIENT_BASED_DURATION
1 Фиксированная длительность FIXED_DURATION
Единицы длительности
Единица Описание Название в системе Karvon
0 Минуты MINUTE
1 Часы HOUR
2 Дни DAY
3 Недели WEEK
4 Месяцы MONTH

Типы выбора локации

Тип Описание Название в системе Karvon
0 Выбор локации осуществляется хостом HOST_BASED
1 Выбор локации осуществляется клиентом CLIENT_BASED
2 Нет выбора локации NONE

Способы оплаты

Способ Описание Название в системе Karvon
0 Оплата онлайн через Karvon NOW
1 Оплата по прибытии LATER

Параметры pricing

Параметр Тип данных JSON Описание
deposit number float Депозит
depositCurrency number int Валюта депозита
latePaymentPercentage number float Процент штрафа за оплату в режиме LATER
prepaymentPercentage number float Процент предоплаты который остается у партнера в случае отмены заказа
price number float Цена
priceCurrency number int Валюта цены
priceDuration number int Длительность цены
priceTimeUnit number int Единица времени цены
pricingMode number int Режим цены
Режимы цены
Режим Описание Название в системе Karvon
0 Фиксированная цена FIXED
1 Цена за единицу времени PER_TIME_UNIT

Параметры rules

Параметр Описание
gracePeriod Период ожидания
minAge Минимальный возраст
rules Правила
ЛокацииЗаказы