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/admin/openapi.full.yaml

@@ -69757,10 +69757,9 @@ components:
         type: unknown_error
   securitySchemes:
     api_token:
-      type: apiKey
+      type: http
       x-displayName: API Token
-      in: header
-      name: x-medusa-access-token
+      scheme: bearer
     jwt_token:
       type: http
       x-displayName: JWT Token

www/apps/api-reference/specs/admin/openapi.yaml

@@ -1028,10 +1028,9 @@ paths:
 components:
   securitySchemes:
     api_token:
-      type: apiKey
+      type: http
       x-displayName: API Token
-      in: header
-      name: x-medusa-access-token
+      scheme: bearer
     jwt_token:
       type: http
       x-displayName: JWT Token

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

www/apps/api-reference/specs/store/paths/store_products.yaml

@@ -789,14 +789,6 @@ get:
               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.
@@ -821,6 +813,22 @@ get:
                 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