Cart

All /cart/* paths use TokenMiddleware (guest token auto-mint). Send cookie or Bearer; do not use query ms3_token.

Mutations

Method	Path	Body (JSON)
POST	/cart/add	id, optional count, options, render
POST	/cart/change	line key + count
POST	/cart/change-option	key + options
POST	/cart/remove	line key
POST	/cart/clean
GET	/cart/get	query: include_thumbs 0|1 (default 0)

Exact line field names: see cart/get response and CartController code. Optional render: snippet tokens for HTML SSR (not Nuxt SSR).

GET /cart/get

After the normalizer (CartResponseNormalizer):

{
  "success": true,
  "message": "",
  "data": {
    "items": [
      {
        "product_key": "123_…",
        "product_id": 123,
        "name": "…",
        "count": 1,
        "price": 1500,
        "cost": 1500,
        "weight": 0.5,
        "options": {},
        "old_price": 0,
        "discount_price": 0,
        "discount_cost": 0
      }
    ],
    "cart": {
      "123_…": {}
    },
    "status": {
      "total_positions": 1,
      "total_count": 1,
      "total_cost": 1500,
      "total_weight": 0.5,
      "total_discount": 0
    }
  }
}

Field	Shape	For
items	always array	Read in new clients
cart	map by product_key	Legacy. Empty cart → {}, not []
status	totals	Products only. Delivery / payment / total: GET /order/cost

Example

curl -c jar.txt -b jar.txt -sS \
  'https://shop.example/assets/components/minishop3/api.php?route=/api/v1/customer/token/get'

curl -c jar.txt -b jar.txt -sS -X POST \
  'https://shop.example/assets/components/minishop3/api.php?route=/api/v1/cart/add' \
  -H 'Content-Type: application/json' \
  -d '{"id":123,"count":1}'

Full flow: Examples. Checkout: Checkout.