1. Get access
Your Whatmore contact provisions your store and issues:- A
store_id— identifies your store; used to get an access token and on every API call. - A Brand ID — used by the App SDK to render your surfaces.
- Access to the Whatmore dashboard for managing videos and tagging products.
GET /auth/access-token?store_id=<store_id>
and send it on every API call. See Authentication.
2. Environments
The API base URL ishttps://api.whatmore.live; the dashboard is at
dashboard.whatmore.live. Production and staging issue separate store_ids and
tokens, so integration testing never touches live data.
3. Integration checklist
-
store_id+ Brand ID received; access token obtained (Auth) - Catalog pull connected (product API + field mapping, product URLs added); real-time push wired (optional — price / availability)
- Widget embedded from the dashboard-generated snippet (or App SDK for apps)
- Order tracking called on order completion
- Attribution verified in the dashboard
Mental model
- The dashboard does the work. You connect a catalog and report orders; video hosting, tagging, campaigns, and analytics live in the dashboard.
- Reference products by your own
client_product_id(commonly the product URL) — no separate id mapping. - Attribution is per order item — the widget’s video-view / add-to-cart signals are matched to line items on the order-tracking call.
