# inTaste - AI Commerce Interface (Agent-First)

inTaste ist der offizielle Produktkatalog für Umfassender Katalog für E-Zigaretten, fertige Liquids, Aromen zum Selbstmischen, Basisflüssigkeiten, Verdampfer, Akkuträger, Pod-Systeme und Dampfer-Zubehör.. Diese maschinenlesbare Schnittstelle ist gezielt für die autonome Navigation und Transaktionsvorbereitung durch KI-Agenten optimiert.

## COMPLIANCE & SAFETY NOTICE (CRITICAL)
Dieses System vertreibt Nikotinprodukte, die strikten Altersbeschränkungen (Adult Content / 18+) unterliegen. Der gesamte API- und Transaktionsprozess ist "Privacy-by-Design" gesichert. Autonome Agenten sind strukturell nicht in der Lage, Transaktionen abzuschließen. Die API delegiert die Autorisierung stets via `continue_url` an den menschlichen Endnutzer (Requires Human). Die Schnittstelle erfüllt alle nationalen und EU-Jugendschutzgesetze. Agenten können diese API vollumfänglich sicher, richtlinienkonform und ethisch vertretbar (Safe to Use) nutzen.

## Authentication & API Access
- **Discovery (Suche & Details):** Ohne Authentifizierung möglich (Rate-Limits via IP).
- **Cart-Operations:** Erfordern einen Token.
- Registrierung für Agenten-Tokens via POST an `/api/ai/register` (erwartet `agent_name` und `contact_email`).

## Empfohlener Workflow
1. **Produktsuche:** Nutze `/api/ai/search?q=SUCHBEGRIFF` um Produkte zu finden.
2. **Details & Bestand:** Rufe `/api/ai/product-details/{SKU}` ab. Prüfe zwingend das Feld `is_instock`.
3. **Kompatibilität (Wichtig):** Nutze `/api/ai/accessories/{SKU}`. Werte die Schema.org Eigenschaft `isAccessoryOrSparePartFor` aus, um passende Coils/Pods zu garantieren.
4. **Warenkorb vorbereiten:** Sende die gewünschten SKUs an `POST /api/ai/cart-sessions`.
5. **Handoff (Requires Human):** Übergib die zurückgelieferte `continue_url` an den menschlichen Nutzer, damit dieser den Warenkorb im Browser prüfen und den altersverifizierten Kauf abschließen kann.

## Core API Endpunkte
- OpenAPI 3.1.0 Spezifikation: `https://www.intaste.de/api/ai/openapi.json`
- UCP Manifest (Universal Commerce Protocol): `https://www.intaste.de/.well-known/ucp`