Shop-Script v.11.6.0

Author: Leonid Vakulenko

api/swagger/v1.yaml

@@ -5437,6 +5437,34 @@ paths:
         400:
           description: Некорректное содержимое запроса.
 
+  /shop.settings.enableHeadless:
+    post:
+      summary: Включает Headless API на указанной витрине магазина
+      security:
+        - ApiKeyAuth: []
+      externalDocs:
+        description: shop.settings.enableHeadless
+        url: https://developers.webasyst.ru/api/explorer/shop/shop.settings.enableHeadless/
+      parameters:
+        - $ref: '#/components/parameters/requestFormat'
+      requestBody:
+        required: true
+        content:
+          application/x-www-form-urlencoded:
+            schema:
+              type: object
+              required:
+                - storefront_url
+              properties:
+                storefront_url:
+                  type: string
+                  description: URL витрины, как указан в shop.settings.get storefronts[].url
+      responses:
+        200:
+          description: Успешное выполнение запроса.
+        400:
+          description: Некорректное содержимое запроса.
+
 #STOCK
   /shop.stock.getInfo:
     get:

api/v1/shop.ai.gpt.method.php

@@ -17,7 +17,7 @@ public function execute()
                 $this->executeProduct();
                 break;
             default:
-                throw new waAPIException('entity_required', 'entity is unknown or missing', 400);
+                throw new waAPIException('entity_required', sprintf_wp('Incorrect or empty “%s” parameter value.', 'entity'), 400);
                 break;
         }
     }
@@ -40,7 +40,7 @@ protected function executeProduct()
                         $product = new shopProduct($product_id);
                         $description_request->loadFieldValuesFromProduct($product);
                     } catch (waException $e) {
-                        throw new waAPIException('product_not_found', 'Bad product_id', 400);
+                        throw new waAPIException('product_not_found', sprintf_wp('Incorrect value of the “%s” parameter.', 'product_id'), 400);
                     }
                 }
 
@@ -104,7 +104,7 @@ protected function executeProduct()
                 break;
 
             default:
-                throw new waAPIException('field_required', 'field is unknown or missing', 400);
+                throw new waAPIException('field_required', sprintf_wp('Incorrect or empty “%s” parameter value.', 'field'), 400);
                 break;
         }
     }

api/v1/shop.category.add.method.php

@@ -20,7 +20,7 @@ public function execute()
         $category_model = new shopCategoryModel();
         $parent_id = waRequest::post('parent_id', 0, 'int');
         if ($parent_id && !$category_model->getById($parent_id)) {
-            throw new waAPIException('invalid_request', 'Parent category not found', 404);
+            throw new waAPIException('invalid_request', _w('Parent category not found.'), 404);
         }
         if (!isset($data['url']) || $data['url'] === '') {
             $data['url'] = shopHelper::transliterate($data['name']);

api/v1/shop.category.update.method.php

@@ -19,7 +19,7 @@ public function execute()
             }
             if (isset($data['parent_id']) && $category['parent_id'] != $data['parent_id']) {
                 if (!$category_model->getById($data['parent_id'])) {
-                    throw new waAPIException('invalid_param', 'Parent category not found', 404);
+                    throw new waAPIException('invalid_param', _w('Parent category not found.'), 404);
                 }
                 if (!$category_model->move($id, null, $data['parent_id'])) {
                     throw new waAPIException('server_error', 500);

api/v1/shop.coupon.getList.method.php

@@ -23,10 +23,10 @@ public function execute()
     protected function validateRequest($offset, $limit, $search, $active_only)
     {
         if ($offset < 0) {
-            throw new waAPIException('invalid_param', 'Param offset must be greater than or equal to zero');
+            throw new waAPIException('invalid_param', _w('An “offset” parameter value must be greater than or equal to zero.'));
         }
         if ($limit < 0) {
-            throw new waAPIException('invalid_param', 'Param limit must be greater than or equal to zero');
+            throw new waAPIException('invalid_param', _w('A “limit” parameter value must be greater than or equal to zero.'));
         }
     }
 

api/v1/shop.customer.search.method.php

@@ -78,11 +78,11 @@ protected function validateRequest()
         $offset = waRequest::request('offset', 0, 'int');
 
         if ($offset < 0) {
-            throw new waAPIException('invalid_param', 'Param offset must be greater than or equal to zero');
+            throw new waAPIException('invalid_param', _w('An “offset” parameter value must be greater than or equal to zero.'));
         }
         $limit = waRequest::request('limit', 100, 'int');
         if ($limit < 0) {
-            throw new waAPIException('invalid_param', 'Param limit must be greater than or equal to zero');
+            throw new waAPIException('invalid_param', _w('A “limit” parameter value must be greater than or equal to zero.'));
         }
     }
 

api/v1/shop.dashboard.customers.method.php

@@ -8,7 +8,7 @@ public function execute()
     {
         $period = waRequest::get('period', 30*24*3600, 'int');
         if ($period <= 0) {
-            throw new waAPIException('invalid_request', 'period must be a positive integer', 400);
+            throw new waAPIException('invalid_request', sprintf_wp('The “%s” parameter value must be a positive integer.', 'period'), 400);
         }
         list($graph_data, $total) = self::getGraphData($period);
         $this->response = array(

api/v1/shop.dashboard.realtime.method.php

@@ -10,9 +10,9 @@ public function execute()
 
         $period = waRequest::get('period', $max_time, waRequest::TYPE_INT);
         if ($period <= 0) {
-            throw new waAPIException('invalid_request', 'period must be a positive integer', 400);
+            throw new waAPIException('invalid_request', sprintf_wp('The “%s” parameter value must be a positive integer.', 'period'), 400);
         } elseif ($period > $max_time) {
-            throw new waAPIException('invalid_request', 'period cannot be more than 48 hours', 400);
+            throw new waAPIException('invalid_request', _w('The “period” parameter value cannot be greater than 48 hours.'), 400);
         }
 
         list($graph_data, $totals) = self::getGraphData($period);

api/v1/shop.dashboard.sales.method.php

@@ -8,7 +8,7 @@ public function execute()
     {
         $period = waRequest::get('period', 30*24*3600, 'int');
         if ($period <= 0) {
-            throw new waAPIException('invalid_request', 'period must be a positive integer', 400);
+            throw new waAPIException('invalid_request', sprintf_wp('The “%s” parameter value must be a positive integer.', 'period'), 400);
         }
         list($graph_data, $totals) = self::getGraphData($period);
         $this->response = array(

api/v1/shop.feature.add.method.php

@@ -15,7 +15,7 @@ public function execute()
         $this->post('name', true);
         $feature_model = new shopFeatureModel();
         if ($feature_model->getByCode($code)) {
-            throw new waAPIException('invalid_param', 'Code '.$code.' already exists');
+            throw new waAPIException('invalid_param', sprintf_wp('Code %s already exists.', $code));
         }
 
         $types =  array(
@@ -27,7 +27,7 @@ public function execute()
         );
 
         if (!in_array($type, $types)) {
-            throw new waAPIException('invalid_param', 'Invalid type: '.$type);
+            throw new waAPIException('invalid_param', sprintf_wp('Invalid type: %s.', $type));
         }
 
         $data = waRequest::post();