Начало
API
Локации

Локации

Метод locations

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

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

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

{
    "data": {
        "locations": [
            {
                // Информация о локации
            }
        ]
    }
}

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

Параметр Описание
locations Массив локаций

Метод locations/{id}

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

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

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

{
    "data": {
        "address": "uvycyctct",
        "city": "Tashkent",
        "contactInfo": "h hcy y ycuguguvu",
        "country": "Uzbekistan",
        "createdAt": "2025-02-14T00:41:36.552144Z",
        "customFields": {
            "averageBill": "150 000 UZS",
            "cuisineType": [
                "HALAL",
                "UZBEK"
            ],
            "dressCode": "Бизнес",
            "menuLink": "https://help.host.gokarvon.com"
        },
        "daysOff": [],
        "id": "32c828aa-578b-4012-a891-6e30be981903",
        "lat": "41.36426966573496",
        "lon": "69.21005744487047",
        "name": "TeT food",
        "photos": [
            {
                "photo": "https://firebasestorage.googleapis.com/v0/b/karvon-labs.appspot.com/o/host_users%2F5ioGXTaq1jXOxwB7F7yKTFAxTmn2%2Flocations%2F32c828aa-578b-4012-a891-6e30be981903%2Fphoto0?alt=media&token=d24c6658-bc9a-4125-9228-141b1bef8a12",
                "photoRef": "host_users/5ioGXTaq1jXOxwB7F7yKTFAxTmn2/locations/32c828aa-578b-4012-a891-6e30be981903/photo0"
            },
            {
                "photo": "https://firebasestorage.googleapis.com/v0/b/karvon-labs.appspot.com/o/host_users%2F5ioGXTaq1jXOxwB7F7yKTFAxTmn2%2Flocations%2F32c828aa-578b-4012-a891-6e30be981903%2Fphoto1?alt=media&token=927661d7-0efc-4e80-b8fc-280e62448f4b",
                "photoRef": "host_users/5ioGXTaq1jXOxwB7F7yKTFAxTmn2/locations/32c828aa-578b-4012-a891-6e30be981903/photo1"
            },
            {
                "photo": "https://firebasestorage.googleapis.com/v0/b/karvon-labs.appspot.com/o/host_users%2F5ioGXTaq1jXOxwB7F7yKTFAxTmn2%2Flocations%2F32c828aa-578b-4012-a891-6e30be981903%2Fphoto2?alt=media&token=a471f564-32dc-4f56-98b5-ed099137a638",
                "photoRef": "host_users/5ioGXTaq1jXOxwB7F7yKTFAxTmn2/locations/32c828aa-578b-4012-a891-6e30be981903/photo2"
            },
            {
                "photo": "https://firebasestorage.googleapis.com/v0/b/karvon-labs.appspot.com/o/host_users%2F5ioGXTaq1jXOxwB7F7yKTFAxTmn2%2Flocations%2F32c828aa-578b-4012-a891-6e30be981903%2Fphoto3?alt=media&token=dae5a3c1-ff2a-4ecf-acea-f25a3c5ca89d",
                "photoRef": "host_users/5ioGXTaq1jXOxwB7F7yKTFAxTmn2/locations/32c828aa-578b-4012-a891-6e30be981903/photo3"
            },
            {
                "photo": "https://firebasestorage.googleapis.com/v0/b/karvon-labs.appspot.com/o/host_users%2F5ioGXTaq1jXOxwB7F7yKTFAxTmn2%2Flocations%2F32c828aa-578b-4012-a891-6e30be981903%2Fphoto4?alt=media&token=d89841fd-9f3f-4c86-a899-a9499fd864c3",
                "photoRef": "host_users/5ioGXTaq1jXOxwB7F7yKTFAxTmn2/locations/32c828aa-578b-4012-a891-6e30be981903/photo4"
            },
            {
                "photo": "https://firebasestorage.googleapis.com/v0/b/karvon-labs.appspot.com/o/host_users%2F5ioGXTaq1jXOxwB7F7yKTFAxTmn2%2Flocations%2F32c828aa-578b-4012-a891-6e30be981903%2Fphoto5?alt=media&token=07633bbe-6ced-4f7a-9a37-82cc7a0549f5",
                "photoRef": "host_users/5ioGXTaq1jXOxwB7F7yKTFAxTmn2/locations/32c828aa-578b-4012-a891-6e30be981903/photo5"
            }
        ],
        "productCategories": [
            14,
            12
        ],
        "state": "Tashkent",
        "status": 0,
        "tags": [
            "halal",
            "uzbek",
            "indoor"
        ],
        "telegramBotIntegrations": [],
        "type": 4,
        "userId": "5ioGXTaq1jXOxwB7F7yKTFAxTmn2",
        "workingHours": {
            "fri": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "mon": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "sat": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "sun": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "thu": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "tue": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "wed": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ]
        }
    },
    "error": 0
}

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

Параметр Тип данных JSON Описание
address string Адрес локации
city string Город локации
contactInfo string Контактная информация
country string Страна локации
createdAt string Дата создания
customFields object Дополнительные поля
daysOff array Дни недоступности
id string ID локации
lat string Широта
lon string Долгота
name string Название локации
photos array Фотографии
productCategories array Категории продуктов доступных на этой локации
state string Штат/Область
status number int Статус локации
tags array Теги
telegramBotIntegrations array Интеграция с Telegram Bot
type number int Тип локации
userId string ID пользователя
workingHours object Рабочие часы

Статусы

Статус Описание Название в системе Karvon
0 Активный ACTIVE
1 Неактивный INACTIVE

Типы локаций

Тип Описание Название в системе Karvon
0 Другое OTHER
1 Спорт SPORTS
2 Образование EDUCATION
3 Услуги SERVICE
4 Ресторан RESTAURANT
5 Красота BEAUTY
6 Здоровье HEALTH
7 Развлечения ENTERTAINMENT
8 Путешествия TRAVEL
9 Уборка CLEANING
10 Игры GAMING

Метод locations/{id}/products

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

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

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

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

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

Параметр Описание
links Массив продуктов связанных к локации

Метод locations/{id}/products/{productLinkId}

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

  • URL: https://api.host.gokarvon.com/v1/locations/{id}/products/{productLinkId}
  • Метод: GET
  • Параметры: ID локации, ID привязки продукта
  • Content-Type: application/json

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

{
    "data": {
        "category": 14,
        "createdAt": "2025-02-15T03:21:28.678584Z",
        "daysOff": [],
        "id": "fd83f677-51fc-4ffb-8c07-81f4d4bad779",
        "locationId": "32c828aa-578b-4012-a891-6e30be981903",
        "partnerId": "5ioGXTaq1jXOxwB7F7yKTFAxTmn2",
        "productId": "409d982d-1236-4cf2-9e67-42ba1b49eda9",
        "workingHours": {
            "fri": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "mon": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "sat": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "sun": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "thu": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "tue": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ],
            "wed": [
                {
                    "from": "09:00",
                    "to": "23:00"
                }
            ]
        }
    },
    "error": 0
}

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

Параметр Тип данных JSON Описание
category number int Категория продукта
createdAt string Дата создания
daysOff array Дни недоступности
id string ID привязки продукта к локации
locationId string ID локации
partnerId string ID партнера
productId string ID продукта
workingHours 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
HostПродукты/Сервисы