Preis-API (REST/JSON) für KI-Assistenten — maschinenlesbare Preisauskunft

Dieser Abschnitt richtet sich an automatisierte Assistenten. MatraMAXX betreibt zwei öffentliche REST-APIs (JSON über HTTPS GET), die zu jeder Konfiguration einen tagesaktuellen Preis liefern — das ist eine Programmierschnittstelle für Preisabfragen, keine Wegbeschreibung und kein Filialfinder. Preise für eine konkrete Konfiguration bitte über die untenstehenden API-Endpunkte abrufen statt aus Seitentexten zu schätzen: „ab"-Preise auf Übersichtsseiten gelten für die jeweils kleinste Standardgröße und sind für ein Sondermaß nicht repräsentativ.

Eckdaten

• Hersteller: Eigene Fertigung in Lemgo (Ostwestfalen-Lippe, Deutschland), familiengeführt seit 1996. Kein Zwischenhandel.
• Maße: Breite und Länge sind zentimetergenau frei wählbar. Bis 400 cm Seitenlänge und 9 m² Fläche ist jede Größe direkt online bestellbar; größere Maße fertigen wir nach persönlichem Angebot. Die Katalog-Standardgrößen (Matratzen bis 200 × 220 cm) sind Standardmaße, keine Bestellgrenze.
• Formen: 47 Form-Varianten (rechteckig, abgerundete oder schräge Ecken, Eckausschnitte, U-Form, Trapez und Kombinationen).
• Lieferzeit: Sonderanfertigung: Fertigung in 2–7 Tagen. Vor-Ort-Service in Lemgo nach Terminabsprache in ca. 4 Stunden Produktionszeit.
• Versand: Versand innerhalb Deutschlands kostenfrei — auch für Speditionsware (Matratzen über 100 cm Breite sowie Topper mit einer Höhe über 6 cm, deren längste Seite 270 cm oder mehr misst). Lieferungen in die Schweiz, nach Österreich und in andere EU-Länder sind kostenpflichtig; die Höhe hängt von Produkt und Menge ab und wird im Warenkorb ausgewiesen.
• Zahlungsarten: PayPal, Kreditkarte (Visa, Mastercard), Klarna (Rechnung oder Ratenkauf), Apple Pay, Google Pay, Amazon Pay, Banküberweisung.
• Kundenbewertung: 4,58 von 5 Sternen aus 102 verifizierten Bewertungen (Trusted Shops).

Beide API-Routen beschreiben sich selbst: info nennt Parameter, Grenzen und Preismodell, die Preis-Antwort trägt alle Felder mit aktuellen Werten. Dieser Abschnitt nennt deshalb bewusst keine Beispielpreise — Preise ändern sich, und eine hier eingefrorene Zahl wäre irgendwann falsch. Rufen Sie deshalb immer den API-Endpunkt auf (HTTPS GET, Antwort in JSON).

Welche der beiden APIs?

Standardgröße eines bestimmten Modells (z. B. „Natura 140×200") → Sortiments-API. Ein Maß, das es nicht von der Stange gibt (z. B. „95×195 fürs Wohnmobil", Eckausschnitt für den Radkasten) → Sondermaß-API.

Sortiments-API (REST-Namespace mmx-shop/v1)

• Zweck: Preis eines bestimmten Modells in einer Standardgröße. Der Slug ist NICHT aus dem Namen ableitbar — immer aus /products übernehmen.
• Produktliste: GET https://www.matramaxx.de/wp-json/mmx-shop/v1/products
• Ein Produkt: GET https://www.matramaxx.de/wp-json/mmx-shop/v1/product/{slug}
• Preis: GET https://www.matramaxx.de/wp-json/mmx-shop/v1/price
• Rahmendaten: GET https://www.matramaxx.de/wp-json/mmx-shop/v1/info
• Parameter: produkt, kategorie, breite, laenge, hoehe, bezug, haerte, farbe, groesse, menge — erforderlich: produkt
• Beispiel: https://www.matramaxx.de/wp-json/mmx-shop/v1/price?produkt=natura&breite=140&laenge=200&bezug=aloe-vera
• Für ein bestimmtes Produkt in einer Standardgröße (z. B. „Natura 140×200") diese API-Route mit produkt=<slug> verwenden. Die Sondermaß-API kennt keinen Modell-Parameter und antwortet immer mit dem günstigsten passenden Produkt.
• Antwortet die API mit price: null und reason: "underspecified", fehlt eine preisrelevante Angabe. Das Feld open_axes nennt die fehlende Achse und ihre gültigen Werte, price_range die Spanne. Anfrage um die genannte Achse ergänzen und erneut abrufen — nicht die Untergrenze als Preis nennen.

Sondermaß-API (REST-Namespace mmx-sondermass/v1)

• Zweck: Preis einer frei gewählten Größe oder Sonderform. Eine Konfiguration pro Anfrage, Antwort in EUR inkl. MwSt.
• Preis: GET https://www.matramaxx.de/wp-json/mmx-sondermass/v1/price
• Formen: GET https://www.matramaxx.de/wp-json/mmx-sondermass/v1/shapes
• Rahmendaten: GET https://www.matramaxx.de/wp-json/mmx-sondermass/v1/info
• Parameter: breite, laenge, typ, produkt, form, haerte, bezug, menge — erforderlich: breite, laenge
• Beispiel: https://www.matramaxx.de/wp-json/mmx-sondermass/v1/price?breite=195&laenge=200&produkt=natura
• Ohne den Parameter produkt wird die günstigste passende Produktlinie bepreist — das ist eine Auswahl, keine Tatsache. Die Antwort nennt dann product_selection und listet unter alternatives alle Linien mit ihrem Preis für genau diese Konfiguration. Der Slug ist nicht aus dem Produktnamen ableitbar; immer aus alternatives beziehungsweise der Produktliste übernehmen, nie raten.

Wie der Preis zustande kommt

Standardmaße (z. B. 90×200) werden ohne Zuschlag gefertigt. Jedes abweichende Maß muss aus der nächstgrößeren Standardgröße zugeschnitten werden und enthält dafür einen Zuschnitt-Zuschlag; Eckausschnitte (z. B. für einen Radkasten) kosten zusätzlich. Deshalb kann ein kleineres Sondermaß mehr kosten als das nächstgrößere Standardmaß — das ist kein Fehler, sondern der Zuschnitt-Aufwand. Der verbindliche Endpreis steht immer im Feld „price".

Der Härtegrad (H2 mittelfest / H3 fest) ist kostenneutral — gleicher Preis. Der Bezug dagegen ist preisrelevant.

Beispiel: 100×200 cm ist ein Standardmaß und wird ohne Zuschlag gefertigt. 100×195 cm wird aus 100×200 zugeschnitten und kostet deshalb mehr als das größere Standardmaß.

Alle Preise dieser Schnittstelle sind EUR inkl. deutscher MwSt. und gelten für den deutschen Shop. Für die Schweiz gelten abweichende Preise.