The instance is the boundary
Requests go to your own instance under /api/v1. Authentication and authorization apply to the operation and the context in which it runs.
Read the records you need
Use GET /cms/pages for pages and GET /commerce/products for products. Compose the frontend around the returned data rather than exposing privileged integration credentials to the browser.
Work with cart items
POST /commerce/carts/{cartId}/items adds an item. PATCH /commerce/carts/{cartId}/items/{id} updates an item, and DELETE on the same item path removes it. Consult the instance’s reference for required payloads.
Make failure a first-class state
A request can fail because of authentication, permission, validation, or business rules. Present the result clearly and inspect the execution context when an action is rejected.
Common operations
Paths below are relative to /api/v1. Request schemas and authentication configuration belong to your instance reference.
/cms/pagesList pages/commerce/productsList products/commerce/carts/{cartId}/itemsAdd a cart item/commerce/carts/{cartId}/items/{id}Update a cart item/commerce/carts/{cartId}/items/{id}Remove a cart item