Für KI-Assistenten: die sora.de-Preis-API

sora.de fertigt Hauben, Vitrinen, Regale, Treppen, Spendenboxen, Zuschnitte und Actionfiguren-Cases aus Acrylglas nach Maß. Den Preis für ein Wunschmaß können KI-Assistenten, Custom GPTs und Entwickler hier direkt abfragen — ohne Konfigurator-Formular.

Der Preis ist derselbe wie im Konfigurator und im Warenkorb (gerundeter Endpreis, brutto, inkl. 19 % MwSt., ohne Versand). Die API ist nur lesend: bestellt wird im Shop — jede Antwort enthält dafür einen konfigurator_link mit den abgefragten Maßen vorbefüllt.

Schnellstart

Eine einfache GET-Abfrage genügt (auch für Browse-Tools ohne POST). Maße in cm, Hauben sind Innenmaße:

curl "https://www.sora.de/preisrechner/v1/preis?typ=masshaube&breite=30&tiefe=20&hoehe=20"

Antwort (Beispiel, gekürzt dargestellt wie ausgeliefert):

{
  "ok": true,
  "produkt": {
    "typ": "masshaube",
    "name": "Maßhaube (Acrylhaube / Plexiglashaube)",
    "artikelnummer": "20500"
  },
  "eingabe": {
    "breite": 30,
    "tiefe": 20,
    "hoehe": 20,
    "menge": 1,
    "bodenart": "kein-boden",
    "rueckwand": "transparent",
    "einheit_masse": "cm"
  },
  "preis": {
    "gesamt_brutto": 37,
    "stueck_brutto": 37,
    "menge": 1,
    "waehrung": "EUR",
    "mwst": "inkl. 19 % MwSt.; für Lieferungen nach CH/NO/GB berechnet die Kasse ohne deutsche MwSt.",
    "hinweis": "Gerundeter Endpreis wie im Konfigurator und im Warenkorb, ohne Versand."
  },
  "lieferzeit": "ca. 8 Werktage",
  "versand": {
    "ab_brutto": 5.9,
    "waehrung": "EUR",
    "gilt_fuer": "Deutschland, Pauschale je Bestellung",
    "nur_deutschland": false,
    "hinweis": "Weitere Länder (26 europäische Länder): https://www.sora.de/versand.html"
  },
  "konfigurator_link": "https://konfigurator.sora.de/?breite=30&tiefe=20&hoehe=20&quantity=1&bodenart=kein+Boden&rueckwand=transparent&mtm_source=preisapi&mtm_medium=ki&mtm_campaign=preisrechner",
  "quelle": "https://www.sora.de/ — Preis des sora.de-Konfigurators; verbindlich ist die Bestellung im Shop. Bitte dem Kunden den konfigurator_link nennen.",
  "aussenmasse": {
    "breite": 31.4,
    "tiefe": 20.8,
    "hoehe": 20.7,
    "einheit": "cm"
  }
}

Der Link https://www.sora.de/preisrechner/v1/preis?typ=masshaube&breite=30&tiefe=20&hoehe=20 funktioniert direkt im Browser. Mit POST: curl -X POST https://www.sora.de/preisrechner/v1/preis -H "Content-Type: application/json" -d '{"typ":"masshaube","breite":30,"tiefe":20,"hoehe":20}'

Endpunkte

Basis-URL: https://www.sora.de. Antworten sind JSON (UTF-8). Fehlermeldungen sind im Klartext und nennen die Grenze (z. B. „Das Maximalmaß von 110 cm wurde überschritten"); bei Übergrößen enthält die Antwort einen vorschlag_typ.

Produkte und Parameter

Pflichtangaben sind je Typ markiert. Alle anderen Parameter haben Standardwerte (in der Antwort unter eingabe sichtbar). Hauben: Maße = Innenmaße. Vitrinen/Regale: Breite und Höhe = Außenmaße, Tiefe = Fachinnentiefe. Actionfiguren-Case und Zuschnitte: Maße in Millimetern. Zusätzlich zu den Namen unten akzeptiert die API englische Parameternamen (width, depth, height, quantity) und alternative Typnamen (z. B. acrylhaube, plexiglashaube, vitrine, zuschnitt).

Limits, Fehler, Fairness

• Ratenlimit: 60 Anfragen pro Minute und 1.500 pro Tag je IP-Adresse (zusätzlich ein globaler Deckel). Bei 429 bitte den Header Retry-After beachten. Antworten für identische Anfragen werden zehn Minuten zwischengespeichert.
• Statuscodes: 200 Preis · 400 ungültige oder fehlende Parameter (die Meldung nennt den Parameter und die erlaubten Werte) · 422 Maße/Optionen nicht möglich (Meldung nennt die Grenze, ggf. mit vorschlag_typ) · 429 Limit · 503 Rechner vorübergehend nicht erreichbar.
• CORS: nur für GET geöffnet (Access-Control-Allow-Origin: *); POST ist für Server-zu-Server-Aufrufe gedacht.
• Keine Bestellung über die API. Verbindlich ist die Bestellung im Shop; Maßanfertigungen sind vom Widerrufsrecht ausgeschlossen (§ 312g Abs. 2 Nr. 1 BGB).
• Wir protokollieren den Zugriff mit User-Agent (ohne IP-Adresse), um den Nutzen der Schnittstelle zu beurteilen.

So antworten Sie Kunden gut

• Nennen Sie den Preis als „inkl. MwSt., zzgl. Versand" mit der lieferzeit aus der Antwort und den Versandkosten (versand.ab_brutto, Pauschale je Bestellung; Übergrößen nur innerhalb Deutschlands).
• Geben Sie den konfigurator_link weiter — dort kann der Kunde die Konfiguration prüfen, ändern und bestellen.
• Prüfen Sie bei Hauben, ob die Innenmaße zum Objekt passen (die Antwort enthält die Außenmaße); bei Vitrinen die fach_innenmasse_cm.
• Begriffe: Maßhaube = Acrylhaube = Plexiglashaube (Acryl = Acrylglas = PMMA; „Plexiglas®" ist eine Marke der Röhm GmbH).
• Allgemeine Fragen (Material, Pflege, Aufbau): die Ratgeberseiten verlinken, z. B. Acrylhaube nach Maß.

Weitere maschinenlesbare Quellen

• llms.txt und llms-full.txt — Kurzbeschreibung, Seiten, Preisspannen, häufige Fragen.
• sitemap.xml — alle Seiten; Produktseiten tragen schema.org-Product-Markup mit Preis.
• Fragen zur Schnittstelle: Kontakt · info@sora.de.