Merge pull request #485 from andimov/patch-1

Rest API. Store header usage in ACCS

Author: keharper

src/pages/rest/index.md

@@ -21,7 +21,7 @@ The APIs can be used to perform a wide array of tasks. For example:
 
 <Edition name="paas" />
 
-[Adobe Commerce on Cloud](https://experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/overview?lang=en), Adobe Commerce on-premises, and [Magento Open Source](https://experienceleague.adobe.com/docs/magento-open-source/user-guide/overview/overview.html?lang=en) all use the same REST API framework. The REST API documentation describes the REST APIs that are available in these versions of Adobe Commerce and Magento Open Source.
+[Adobe Commerce on Cloud](https://experienceleague.adobe.com/en/docs/commerce-on-cloud/user-guide/overview?lang=en), Adobe Commerce on-premises, and [Magento Open Source](https://experienceleague.adobe.com/en/docs/commerce-admin/start/guide-overview) all use the same REST API framework. The REST API documentation describes the REST APIs that are available in these versions of Adobe Commerce and Magento Open Source.
 
 ### Endpoints
 
@@ -63,8 +63,27 @@ The authentication system supports both [interactive user-based workflows](./aut
 
 ### URL structure
 
-The URL structure for your REST endpoints will be slightly different in Adobe Commerce as a Cloud Service. In addition to your base URL changing, the route no longer contains the string `/rest`, nor does it contain the store view code. The store view code is specified in the `Store` header of the request.
+In Adobe Commerce as a Cloud Service, REST endpoint URLs do not include `/rest` or the store view code. The store scope is specified via the `Store` HTTP header.
 
-Cloud Service URLs use the following format:
+* Base format:
 
-`https://<server>.api.commerce.adobe.com/<tenant-id>/<endpoint>`
+  `https://<server>.api.commerce.adobe.com/<tenant-id>/<endpoint>`
+
+* Set the scope with the `Store` header:
+
+  * Predefined values:
+
+    * `Store: all` — Execute in the global scope
+    * `Store: default` — Target the default store view (or use your specific store view code)
+
+  * You can also pass any specific store view code: `Store: <store_view_code>`
+
+The following `curl` command shows the request pattern:
+
+```bash
+curl --location 'https://<server>.api.commerce.adobe.com/<tenant-id>/<endpoint>' \
+  --header 'Authorization: Bearer <token>' \
+  --header 'Content-Type: application/json' \
+  --header 'Store: <all | default | <store_view_code>>'
+  ....
+```