docs: fix and improve details on sending authenticated requests with API token (#10744)

* docs: fix and improve details on sending authenticated requests with API token

* fix security schema

www/apps/api-reference/specs/store/openapi.full.yaml

@@ -5031,14 +5031,6 @@ paths:
                   type: string
                   title: category_id
                   description: A product category's ID.
-        - name: currency_code
-          in: query
-          description: The currency code to retrieve prices in.
-          required: false
-          schema:
-            type: string
-            title: currency_code
-            description: The currency code to retrieve prices in.
         - name: variants
           in: query
           description: Filter the products' variants.
@@ -5063,6 +5055,22 @@ paths:
                     type: string
                     title: value
                     description: Filter by a value of the option.
+        - name: country_code
+          in: query
+          description: The product's country code.
+          required: false
+          schema:
+            type: string
+            title: country_code
+            description: The product's country code.
+        - name: cart_id
+          in: query
+          description: The product's cart id.
+          required: false
+          schema:
+            type: string
+            title: cart_id
+            description: The product's cart id.
       x-codeSamples:
         - lang: Shell
           label: cURL