{"data":{"info":{"developer":"Kitty_Ilnazik","github":"https://github.com/dev-kitty-ilnazik/tg-shop-backend","docs":"http://api.business-solutions.store/docs","swagger":"http://api.business-solutions.store/swagger","redoc":"http://api.business-solutions.store/redoc","api_url":"http://api.business-solutions.store/"},"api_structure":{"/versions":{"path":"http://api.business-solutions.store/versions","methods":["GET"],"summary":"API Versions","description":"Returns information about all API versions with changes and endpoints","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false},"/v1":{"tags":["v1 - users"],"/users":{"path":"http://api.business-solutions.store/v1/users/","methods":["GET"],"summary":"Get all users","description":"Returns a paginated list of all users in the system.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false,"/get":{"path":"http://api.business-solutions.store/v1/users/get","methods":["GET"],"summary":"Get user by id","description":"Returns a user by id.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false,"/me":{"path":"http://api.business-solutions.store/v1/users/get/me","methods":["GET"],"summary":"Get current user","description":"Returns the current user.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/update":{"tags":["v1 - users"],"/me":{"path":"http://api.business-solutions.store/v1/users/update/me","methods":["PUT"],"summary":"Update current user","description":"Updates the current user.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/delete":{"tags":["v1 - users"],"/me":{"path":"http://api.business-solutions.store/v1/users/delete/me","methods":["DELETE"],"summary":"Delete current user","description":"Deletes the current user.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/accept":{"tags":["v1 - users"],"/privacy":{"tags":["v1 - users"],"/policy":{"path":"http://api.business-solutions.store/v1/users/accept/privacy/policy","methods":["PUT"],"summary":"Accept privacy policy","description":"Accepts the privacy policy.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}}},"/decline":{"tags":["v1 - users"],"/privacy":{"tags":["v1 - users"],"/policy":{"path":"http://api.business-solutions.store/v1/users/decline/privacy/policy","methods":["PUT"],"summary":"Decline privacy policy","description":"Declines the privacy policy.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}}},"/check":{"tags":["v1 - users"],"/channel":{"tags":["v1 - users"],"/subscription":{"path":"http://api.business-solutions.store/v1/users/check/channel/subscription","methods":["GET"],"summary":"Check channel subscription","description":"Checks if the current user is subscribed to the BusinessSolutionsGroup Telegram channel.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}}},"/balance":{"tags":["v1 - users - balance"],"/get":{"tags":["v1 - users - balance"],"/{tg_id}":{"path":"http://api.business-solutions.store/v1/users/balance/get/{tg_id}","methods":["GET"],"summary":"Get user's balance","description":"Retrieve the current balance for a user by their Telegram ID. Admin only.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/add":{"tags":["v1 - users - balance"],"/{tg_id}":{"path":"http://api.business-solutions.store/v1/users/balance/add/{tg_id}","methods":["PUT"],"summary":"Add funds to user's balance","description":"Add a positive amount of funds to the user's balance identified by Telegram ID.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false}},"/withdraw":{"tags":["v1 - users - balance"],"/{tg_id}":{"path":"http://api.business-solutions.store/v1/users/balance/withdraw/{tg_id}","methods":["PUT"],"summary":"Withdraw funds from user's balance","description":"Withdraw a positive amount of funds from the user's balance identified by Telegram ID. Operation fails if insufficient funds.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false}}},"/payments":{"tags":["v1 - users - payments"],"/me":{"path":"http://api.business-solutions.store/v1/users/payments/me","methods":["GET"],"summary":"Get user payments","description":"Get all payments for a user","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}}},"/payments":{"tags":["v1 - payments - xRocket"],"/xrocket":{"tags":["v1 - payments - xRocket"],"/create":{"path":"http://api.business-solutions.store/v1/payments/xrocket/create","methods":["POST"],"summary":"Create xRocket payment","description":"Creates a new payment through xRocket","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/currencies":{"path":"http://api.business-solutions.store/v1/payments/xrocket/currencies","methods":["GET"],"summary":"Get available xRocket currencies","description":"Returns list of currencies supported by xRocket invoices","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/rates":{"path":"http://api.business-solutions.store/v1/payments/xrocket/rates","methods":["GET"],"summary":"Get xRocket crypto rates in USDT","description":"Returns rates for requested assets via xRocket trade API","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/convert":{"path":"http://api.business-solutions.store/v1/payments/xrocket/convert","methods":["GET"],"summary":"Convert USDT to crypto via xRocket","description":"Returns crypto amount for given USDT amount and asset","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/check":{"tags":["v1 - payments - xRocket"],"/{payment_id}":{"path":"http://api.business-solutions.store/v1/payments/xrocket/check/{payment_id}","methods":["GET"],"summary":"Check payment status","description":"Checks current payment status in xRocket and updates status in database","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/webhook":{"path":"http://api.business-solutions.store/v1/payments/xrocket/webhook","methods":["POST"],"summary":"xRocket webhook","description":"Handles notifications from xRocket about payment status","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false}}},"/storage":{"tags":["v1 - storage"],"/upload":{"path":"http://api.business-solutions.store/v1/storage/upload","methods":["POST"],"summary":"Загрузка файла изображения","description":"Принимает файл изображения и возвращает публичную ссылку","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false}},"/shop":{"tags":["v1 - shop - categories"],"/categories":{"path":"http://api.business-solutions.store/v1/shop/categories/","methods":["GET"],"summary":"Get all categories","description":"Returns a paginated list of all categories in the system.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false,"/get":{"path":"http://api.business-solutions.store/v1/shop/categories/get","methods":["GET"],"summary":"Get category by id","description":"Returns a category by id.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false},"/create":{"path":"http://api.business-solutions.store/v1/shop/categories/create","methods":["POST"],"summary":"Create category","description":"Creates a new category.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/update":{"path":"http://api.business-solutions.store/v1/shop/categories/update","methods":["PUT"],"summary":"Update category","description":"Updates an existing category.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/delete":{"path":"http://api.business-solutions.store/v1/shop/categories/delete","methods":["DELETE"],"summary":"Delete category","description":"Deletes a category by id.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false}},"/products":{"path":"http://api.business-solutions.store/v1/shop/products/","methods":["GET"],"summary":"Get all products","description":"Retrieve a paginated list of all products available in the system.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false,"/get":{"path":"http://api.business-solutions.store/v1/shop/products/get","methods":["GET"],"summary":"Get product by ID","description":"Retrieve a single product by its ID.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false},"/create":{"path":"http://api.business-solutions.store/v1/shop/products/create","methods":["POST"],"summary":"Create a new product","description":"Add a new product to the system. Only administrators are allowed to perform this action.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/update":{"path":"http://api.business-solutions.store/v1/shop/products/update","methods":["PUT"],"summary":"Update product details","description":"Update an existing product's information. Only administrators are allowed to perform this action.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true,"/stock":{"path":"http://api.business-solutions.store/v1/shop/products/update/stock","methods":["PUT"],"summary":"Update product stock quantity","description":"Change the stock quantity of a product by its ID.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/keys":{"tags":["v1 - shop - products"],"/import":{"path":"http://api.business-solutions.store/v1/shop/products/keys/import","methods":["POST"],"summary":"Import product keys from CSV","description":"Import keys for a product from a CSV/text file where each line is a single key. Stock quantity becomes the number of unused keys.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/import-zip":{"path":"http://api.business-solutions.store/v1/shop/products/keys/import-zip","methods":["POST"],"summary":"Import ZIP file for product","description":"Upload a ZIP file and attach it as a single product key.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/countries":{"path":"http://api.business-solutions.store/v1/shop/products/countries","methods":["GET"],"summary":"Get all unique countries","description":"Retrieve a list of all unique countries from products.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false},"/notify":{"path":"http://api.business-solutions.store/v1/shop/products/notify","methods":["POST"],"summary":"Subscribe to product restock notifications","description":"Subscribe to notifications when a product is back in stock.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/delete":{"path":"http://api.business-solutions.store/v1/shop/products/delete","methods":["DELETE"],"summary":"Delete a product","description":"Remove a product from the system by its ID. Also removes all related cart items and preorders.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/files":{"path":"http://api.business-solutions.store/v1/shop/products/files","methods":["GET"],"summary":"Get product files","description":"Get all files (keys and ZIP files) for a specific product.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true,"/{file_id}":{"path":"http://api.business-solutions.store/v1/shop/products/files/{file_id}","methods":["PUT"],"summary":"Update product file","description":"Update a product file by uploading a new file.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}}},"/cart":{"path":"http://api.business-solutions.store/v1/shop/cart/","methods":["GET"],"summary":"Get user's cart","description":"Retrieve the current user's cart with all items.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true,"/add":{"path":"http://api.business-solutions.store/v1/shop/cart/add","methods":["POST"],"summary":"Add item to cart","description":"Add a product to the current user's cart.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/update":{"path":"http://api.business-solutions.store/v1/shop/cart/update","methods":["PUT"],"summary":"Update item quantity","description":"Update quantity of a specific item in the user's cart.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/availability":{"path":"http://api.business-solutions.store/v1/shop/cart/availability","methods":["GET"],"summary":"Get product availability by country","description":"Return available count for a product and country.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false,"/bulk":{"path":"http://api.business-solutions.store/v1/shop/cart/availability/bulk","methods":["POST"],"summary":"Get product availability for multiple items","description":"Return available count for multiple products and countries.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false}},"/update-country":{"path":"http://api.business-solutions.store/v1/shop/cart/update-country","methods":["PUT"],"summary":"Update cart item country","description":"Update selected country for a cart item.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/delete":{"path":"http://api.business-solutions.store/v1/shop/cart/delete","methods":["DELETE"],"summary":"Delete cart item","description":"Remove an item from the cart by ID.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/purchases":{"path":"http://api.business-solutions.store/v1/shop/purchases/","methods":["GET"],"summary":"Get user's purchased products","description":"Retrieve the products already purchased by the current user.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true,"/statistics":{"path":"http://api.business-solutions.store/v1/shop/purchases/statistics","methods":["GET"],"summary":"Get project purchase statistics","description":"Retrieve statistics about all purchases across the entire project including total products sold, revenue, and unique customers.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false},"/buy-many":{"path":"http://api.business-solutions.store/v1/shop/purchases/buy-many","methods":["POST"],"summary":"","description":"","responses":{},"dependencies":true},"/send":{"path":"http://api.business-solutions.store/v1/shop/purchases/send","methods":["POST"],"summary":"Resend purchase info to bot","description":"Send product information and keys associated with the purchase to the user's Telegram chat.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/preorders":{"path":"http://api.business-solutions.store/v1/shop/preorders/","methods":["GET"],"summary":"Get user's pre-orders","description":"Retrieve the pre-orders made by the current user.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/webhooks":{"tags":["v1 - webhooks - telegram"],"/telegram":{"path":"http://api.business-solutions.store/v1/webhooks/telegram/","methods":["POST"],"summary":"Telegram Webhook","description":"Receives and processes updates from Telegram Bot API","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false}},"/admins":{"path":"http://api.business-solutions.store/v1/admins/","methods":["GET"],"summary":"Get all admins","description":"Returns a paginated list of all admins in the system.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true,"/get":{"path":"http://api.business-solutions.store/v1/admins/get","methods":["GET"],"summary":"Get admin by id","description":"Returns an admin by id.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/make":{"tags":["v1 - admins"],"/admin":{"path":"http://api.business-solutions.store/v1/admins/make/admin","methods":["POST"],"summary":"Make user admin","description":"Makes a user an admin.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/remove":{"tags":["v1 - admins"],"/admin":{"path":"http://api.business-solutions.store/v1/admins/remove/admin","methods":["POST"],"summary":"Remove admin role from user","description":"Removes the admin role from a user.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/users":{"tags":["v1 - admins"],"/balances":{"path":"http://api.business-solutions.store/v1/admins/users/balances","methods":["GET"],"summary":"Get all users with balances","description":"Returns a paginated list of all users with their balances. Admin only.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/non-admins":{"path":"http://api.business-solutions.store/v1/admins/users/non-admins","methods":["GET"],"summary":"Get all non-admin users","description":"Returns a paginated list of all users who are not administrators. Admin only.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/purchases":{"path":"http://api.business-solutions.store/v1/admins/purchases","methods":["GET"],"summary":"Get all purchases","description":"Returns a paginated list of all purchases from all users. Admin only.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/payments":{"path":"http://api.business-solutions.store/v1/admins/payments","methods":["GET"],"summary":"Get all payments","description":"Returns a paginated list of all payments from all users. Admin only.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/preorders":{"path":"http://api.business-solutions.store/v1/admins/preorders","methods":["GET"],"summary":"Get all pre-orders","description":"Returns a paginated list of all pre-orders from all users. Admin only.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}},"/faq":{"path":"http://api.business-solutions.store/v1/faq/","methods":["GET"],"summary":"Get all FAQ items","description":"Returns a list of all FAQ items ordered by category and order.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false,"/get":{"path":"http://api.business-solutions.store/v1/faq/get","methods":["GET"],"summary":"Get FAQ item by ID","description":"Returns a specific FAQ item by its ID.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false},"/search":{"path":"http://api.business-solutions.store/v1/faq/search","methods":["GET"],"summary":"Search FAQ items","description":"Search FAQ items by question or answer content.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":false},"/create":{"path":"http://api.business-solutions.store/v1/faq/create","methods":["POST"],"summary":"Create FAQ item","description":"Create a new FAQ item. Admin access required.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/update":{"path":"http://api.business-solutions.store/v1/faq/update","methods":["PUT"],"summary":"Update FAQ item","description":"Update an existing FAQ item. Admin access required.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true},"/delete":{"path":"http://api.business-solutions.store/v1/faq/delete","methods":["DELETE"],"summary":"Delete FAQ item","description":"Delete an existing FAQ item. Admin access required.","responses":{"200":{"description":"Successful response with API structure"},"400":{"description":"Bad request — invalid or missing parameters"},"401":{"description":"Unauthorized — authentication required or invalid token"},"403":{"description":"Forbidden — user does not have permission to access this resource"},"404":{"description":"Not found — the requested resource does not exist"},"422":{"description":"Unprocessable Entity — validation error"},"429":{"description":"Too Many Requests — rate limit exceeded"},"500":{"description":"Internal server error"}},"dependencies":true}}}}},"message":"API structure successfully retrieved"}