FoodApi
All URIs are relative to https://business.apis.kesk.app/v1
| Method | HTTP request | Description |
|---|---|---|
| addToFoodCart | POST /food/restaurants/{vendor_id}/{location_id}/cart/items | Add a product to the restaurant cart. |
| clearFoodCart | DELETE /food/restaurants/{vendor_id}/{location_id}/cart | Clear all items from the restaurant cart. |
| getFoodCart | GET /food/restaurants/{vendor_id}/{location_id}/cart | Get cart for a specific restaurant location. |
| getFoodProduct | GET /food/products/{id} | Get food product details |
| getFoodProductQuantityInCart | GET /food/restaurants/{vendor_id}/{location_id}/cart/product/{product_id}/quantity | Get quantity information for a product in the cart. |
| getRestaurant | GET /food/restaurants/{id} | Get restaurant (location) details |
| listFoodCategories | GET /food/categories | List food categories |
| listFoodProducts | GET /food/products | List food products |
| listFoodSubcategories | GET /food/categories/{category_id}/subcategories | List food subcategories |
| listRestaurants | GET /food/restaurants | List restaurants (locations) |
| removeFromFoodCart | DELETE /food/restaurants/{vendor_id}/{location_id}/cart/items | Remove an item from the restaurant cart. |
| updateFoodCartItem | PUT /food/restaurants/{vendor_id}/{location_id}/cart/items | Update an item in the restaurant cart. |
| validateFoodCartAddition | POST /food/restaurants/{vendor_id}/{location_id}/cart/validate | Validate if a product can be added to the cart. |
addToFoodCart
CartResponse addToFoodCart(vendor_id, location_id, AddToCartRequest)
Add a product to the restaurant cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| AddToCartRequest | AddToCartRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8
clearFoodCart
String clearFoodCart(vendor_id, location_id)
Clear all items from the restaurant cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] |
Return type
String
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getFoodCart
CartResponse getFoodCart(vendor_id, location_id)
Get cart for a specific restaurant location.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getFoodProduct
ProductResponse getFoodProduct(id, authorization)
Get food product details
Retrieves detailed information about a specific menu item, including pricing, customization options, and nutritional info.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | Long | Unique identifier of the product | [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getFoodProductQuantityInCart
ProductQuantityResponse getFoodProductQuantityInCart(vendor_id, location_id, product_id)
Get quantity information for a product in the cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| product_id | Long | [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
getRestaurant
RestaurantDetails getRestaurant(id, authorization)
Get restaurant (location) details
Retrieves detailed information about a specific restaurant location. The ID is the location ID, not the vendor ID.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | Long | Unique identifier of the restaurant (location ID) | [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listFoodCategories
List listFoodCategories()
List food categories
Retrieves all food/cuisine categories for restaurants.
Parameters
This endpoint does not need any parameter.
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listFoodProducts
ProductListResponse listFoodProducts(restaurant_id, vendor_id, menu_id, category_id, sub_category_id, is_open, latitude, longitude, keyword, type, page, per_page, authorization)
List food products
Retrieves menu items from restaurants with optional filtering by restaurant (location), category, and keyword search.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| restaurant_id | Long | Filter by specific restaurant ID (location ID) | [optional] [default to null] |
| vendor_id | Long | Filter by specific vendor ID (company - includes all locations) | [optional] [default to null] |
| menu_id | Long | Filter by menu ID | [optional] [default to null] |
| category_id | Long | Filter by category ID | [optional] [default to null] |
| sub_category_id | Long | Filter by sub-category ID | [optional] [default to null] |
| is_open | Boolean | Filter to show only products from currently open restaurants | [optional] [default to null] |
| latitude | Double | User’s latitude for location-based filtering | [optional] [default to null] |
| longitude | Double | User’s longitude for location-based filtering | [optional] [default to null] |
| keyword | String | Search keyword to filter products | [optional] [default to null] |
| type | ProductListType | Filter/sort type: best (most sales), for_you, flash, new, featured | [optional] [default to null] [enum: vendor, normal, best, for_you, flash, new, featured] |
| page | Long | Page number for pagination (default: 1) | [optional] [default to null] |
| per_page | Long | Items per page for pagination (default: 10) | [optional] [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listFoodSubcategories
List listFoodSubcategories(category_id)
List food subcategories
Retrieves all subcategories for a specific food category.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| category_id | Long | Parent category ID | [default to null] |
Return type
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
listRestaurants
PaginatedResponse_RestaurantListItem listRestaurants(latitude, longitude, radius_km, page, per_page, authorization)
List restaurants (locations)
Retrieves restaurant locations with optional geo-filtering. Each restaurant is a vendor_location - a vendor can have multiple restaurants. Results are filtered by proximity within 50km if coordinates are provided.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| latitude | Double | Latitude for geo-filtering restaurants within radius | [optional] [default to null] |
| longitude | Double | Longitude for geo-filtering restaurants within radius | [optional] [default to null] |
| radius_km | Double | Search radius in kilometers (default: 50) | [optional] [default to null] |
| page | Long | Page number for pagination (default: 1) | [optional] [default to null] |
| per_page | Long | Items per page for pagination (default: 20) | [optional] [default to null] |
| authorization | String | Optional JWT bearer token for authenticated requests | [optional] [default to null] |
Return type
PaginatedResponse_RestaurantListItem
Authorization
No authorization required
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
removeFromFoodCart
CartResponse removeFromFoodCart(vendor_id, location_id, RemoveFromCartRequest)
Remove an item from the restaurant cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| RemoveFromCartRequest | RemoveFromCartRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8
updateFoodCartItem
CartResponse updateFoodCartItem(vendor_id, location_id, UpdateCartItemRequest)
Update an item in the restaurant cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| UpdateCartItemRequest | UpdateCartItemRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8
validateFoodCartAddition
CartValidationResponse validateFoodCartAddition(vendor_id, location_id, CartValidationRequest)
Validate if a product can be added to the cart.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| vendor_id | Long | [default to null] | |
| location_id | Long | [default to null] | |
| CartValidationRequest | CartValidationRequest |
Return type
Authorization
HTTP request headers
- Content-Type: application/json; charset=utf-8
- Accept: application/json; charset=utf-8