Dokumentation
Integration

API



Die API-Parameter und Einstellungen können über den entsprechenden Menüpunkt API in der Rubrik Integrationen aufgerufen werden.

Geben Sie in dem Bereich Basic Auth Headers die Benutzerkennung und das Passwort des Benutzers an, der Zugriff auf die API erhalten soll.
Sofern keine ID bei den URL Parametern eingetragen ist, werden alle Datensätze des Endpunktes angesprochen.

Mittels des Buttons Ausführen gibt das System die eingestellte Abfrage als Vorschau aus.

Vorschau

GET /api.php?v=1&ep=accounts
Host: beispiel.host
Authorization: Basic aBcDeF0gHiJk1LmNoP2
Client: 00000
Über den Objektmanager lassen sich gezielt Objekte (Endpunkte) oder einzelne Felder für den Zugriff via API freischalten bzw. deaktivieren.

Erweiterte Abfragen

Für die GET-Methode, kann die Abfrage neben der ID auch über jedes andere verfügbare Feld gefiltert werden. Fügen Sie hierzu das gewünschte Feld mit zugehörigem Wert als GET Parameter an die URL.

/api.php?v=1&ep=quote_lines&quote_id=10 {
  "100": {
   "quote_id": "10",
   "number": "1",
   "position": "Beispielfenster",
   "quantity": "2.00",

...

Erweiterte Services

Neben den Objektabfragen via API kann auch auf verschiedene Services zugegriffen werden. Services bieten die Möglichkeit (dynamische) Daten zu erzeugen und abzurufen. Als id wird der Datensatzschlüssel gefordert.

svcConfigurationQuoteDescription
Liefert den Namen und die Beschreibung von konfigurierten Angebotspositionen.

/api.php?v=1&ep=svcConfigurationQuoteDescription&id=100

svcShopCache
Gibt mit einer Abfrage die Informationen der folgenden Endpunkte aus: company_informations, web_preferences, images, web_navigation, web_navigation_items, web_pages, windows, doors, shadings, window_sills, articles, payment_methods

/api.php?v=1&ep=svcShopCache

svcReferencePrices
Ermittelt den Referenzpreis für die jeweilige Standardkonfiguration aller Systeme für einen Typen.
Benötigt den Parameter type mit einem der folgenden Werte: window, door, shading, window_sill

/api.php?v=1&ep=svcReferencePrices&type=window

svcDoorInfills
Gibt bis zu 32 Füllungen mit entsprechenden Füllungseigenschaften für ein Haustürsystem zurück.
Benötigt den Parameter id mit der ID des Haustürsystems.

/api.php?v=1&ep=svcDoorInfills&type=door&id=1

svcShadingSurfaces
Gibt bis zu 32 Oberflächenfarben für ein Verschattungssystem zurück.
Benötigt den Parameter id mit der ID des Verschattungssystems.

/api.php?v=1&ep=svcShadingSurfaces&type=shading&id=1

svcProductTypes
Gibt bis zu 16 Produkttypen für ein Fenstersystem zurück.
Benötigt den Parameter id mit der ID des Fenstersystems.

/api.php?v=1&ep=svcProductTypes&type=window&id=1
Wir verwenden Cookies, um die Nutzung unserer Website für Sie zu optimieren. Cookies sind nicht nur hilfreich, wenn es darum geht, ein persönliches Nutzererlebnis und passende Anzeigen für Sie zu gewährleisten, sondern sie erweisen sich außerdem als sehr hilfreich bei unserer Webanalyse. Weitere Informationen zu den verschiedenen Cookies, die wir verwenden, finden Sie in unserer Datenschutzerklärung.


Ablehnen
Cookies zulassen