DirectoriesX V1 APIs

Einführung

Q Directories ist das öffentliche allgemeine Branchenverzeichnis für den Strassenbau. Zurzeit können dort Mischwerke und deren angebotene Mischgutartikel veröffentlicht oder abgerufen werden. Jeder Betreiber eines Mischwerks ist eingeladen, Informationen über sein Angebot mittels Q Directories zur Verfügung zu stellen. Die Informationen sind öffentlich und können von Baufirmen und anderen interessierten Organisationen verwendet werden, um Bauprojekte und Bestellungen zu planen.

Die DirectoriesX API ist die zentrale REST API zur Abfrage des Verzeichnisses und zur Pflege der Einträge. Neben der manuellen Erfassung von Mischwerken und Artikeln bildet sie den zweiten Kanal, über den Anbieter ihre Informationen pflegen können. Für Kunden von Mischanlagen ist die API eine Alternative zur manuellen Suche nach Anbieter-Information über die Q Directories Webseite. In beiden Fällen wird die Datenverarbeitung durch die API stark beschleunigt.

Diese Dokumentation beschreibt sämtliche Methoden der API. Hierbei werden die Methoden zur Suche nach Anbieter-Information und der damit in Verbindung stehenden Abfrage sowie die Verwaltung der Verzeichniseinträge getrennt.

Suche und Abfrage von Anbieter-Informationen

  • Normartikel - Mit Hilfe der API lassen sich die Normartikel einer bestimmten Region bzw. eines Landes abrufen.

  • Suche nach Mischwerke und Artikel - Suche bzw. Abfrage von bestimmten Mischwerken und Artikel.

Die technischen Details und eine Beschreibung der einzelnen Methoden finden sie in der API-Referenz.

Verwaltung der Verzeichniseinträge

  • Verwaltung der Mischwerke - Über die API lassen sich die Mischwerke und die eines bestimmten Betreibers verwalten. Zu diesen Informationen zählen z.B. Betreiberfirma, Öffnungszeiten, Standort oder Lieferbedingungen. Kunden einer Mischanlage nutzen diese Information, um zu entscheiden, welche Mischanlage als Lieferantin für ihr Bauprojekt in Frage kommt.

  • Verwaltung des Artikelverzeichnisses - Zu jeder der erfassten Mischwerke lässt sich ein Artikelverzeichnis veröffentlichen. Dies umfasst neben der eindeutigen Bezeichnung der Artikel auch Informationen über die Verfügbarkeit und Standardpreis auch technische Daten wie Raumdichte, Verladetemperatur oder Materialinformationen. Kunden der Mischanlage nutzen diese Information, um zu entscheiden, mit welchem Mischgutartikel sie ihr Bauprojekt umsetzen können. Die API erlaubt die Verwaltung dieses Verzeichnisses. 

Die technischen Details und eine Beschreibung der einzelnen Methoden finden Sie in der API-Referenz.