# SONNENALLEE | HANF - FACHMARKT
> Online shop with AI Shopping API. Use the endpoints below to search products, manage carts, and prepare checkout.

## API Base URL
https://test.schall-rauch.de/ai/v1

## Endpoints

### Products
- GET https://test.schall-rauch.de/ai/v1/products?q={query}&category={id}&sort={sort}&page={p}&limit={n}&lang={iso}
  Search products. Sort options: relevance, price_asc, price_desc, name_asc, name_desc. Returns: products array with id, name, sku, price, images, url.
- GET https://test.schall-rauch.de/ai/v1/products/{id}?lang={iso}
  Full product detail including variants, reviews, attributes, related products, categories.
- GET https://test.schall-rauch.de/ai/v1/products/compare?ids={id1},{id2}&lang={iso}
  Compare 2-5 products side by side with attribute matrix.

### Categories
- GET https://test.schall-rauch.de/ai/v1/categories?lang={iso}
  All categories as hierarchical tree.
- GET https://test.schall-rauch.de/ai/v1/categories/{id}?lang={iso}
  Category detail with products.

### Cart
- POST https://test.schall-rauch.de/ai/v1/cart
  Create empty cart. Returns: {"token": "...64-char hex..."}
- GET https://test.schall-rauch.de/ai/v1/cart/{token}
  View cart contents, items, subtotal.
- POST https://test.schall-rauch.de/ai/v1/cart/{token}/add
  Add product. Body: {"product_id": 123, "quantity": 1}
- DELETE https://test.schall-rauch.de/ai/v1/cart/{token}/items/{index}
  Remove item by index.
- PATCH https://test.schall-rauch.de/ai/v1/cart/{token}/items/{index}
  Update quantity. Body: {"quantity": 2}

### Checkout
- GET https://test.schall-rauch.de/ai/v1/shipping-methods?country={ISO}
  Available shipping methods for a country (e.g. AT, DE).
- POST https://test.schall-rauch.de/ai/v1/cart/{token}/checkout
  Prepare checkout. Body: {"customer": {"first_name": "...", "last_name": "...", "email": "...", "street": "...", "zip": "...", "city": "...", "country": "AT"}, "shipping_method_id": 8}
  Returns a checkout_url the customer opens in their browser to complete payment.

### Shop Info
- GET https://test.schall-rauch.de/ai/v1/shop-info
  Shop name, currency, languages, capabilities.

## Important Notes
- All prices in EUR, VAT included
- Language parameter: lang=ger (German) or lang=eng (English)
- Cart tokens are 64-character hex strings returned by POST /cart
- Checkout URL is one-time use — the customer clicks it to pay
- No authentication required