Netzwerk- und Unternehmensdaten

Wozu diese Schnittstelle

ProHolz Tirol pflegt seit Jahrzehnten eine Unternehmensdatenbank. Darin sind die Betriebe nicht nur erfasst, sondern auch den Kooperationen zugeordnet, die ProHolz betreut — dem Holzcluster, dem Netzwerk Zirbe, dem Holzbau Team Tirol und weiteren. Diese Zuordnungen sind der Kern dessen, was auf der Website sichtbar werden soll.

Die Schnittstelle stellt diese Daten bereit. Sie ist die Grenze zwischen den beiden Aufgabenbereichen: ProHolz und MINDSTREAM verantworten die Daten und ihre Bereitstellung, die Website-Seite verantwortet Darstellung, Navigation, Filterung und Gestaltung vollständig eigenständig.

Die Schnittstelle ist ausschließlich lesend. Die Datenpflege bleibt unverändert in den bestehenden ProHolz-Systemen — es entsteht keine zweite Stelle, an der Daten gepflegt werden müssten.

Was in den Daten steckt

Zum Stand dieser Beschreibung enthält die Datenbank folgende Bestände. Die Zahlen sind nützlich, um den Zuschnitt der Darstellung abzuschätzen.

Die 2.700 Unternehmen sind der Gesamtbestand, überwiegend aus dem Abgleich mit der Wirtschaftskammer. Für die Darstellung auf der Website sind die kuratierten Netzwerke relevant — sie sind deutlich kleiner und dafür wesentlich besser gepflegt:

Daneben bestehen die fachlichen Gruppen aus dem Kammerabgleich — Tischler und holzgestaltende Gewerbe, Holzbau, Holzindustrie, Handel, Gewerbliche Dienstleister, Kunsthandwerke, Papierindustrie. Sie umfassen den Großteil der 2.700 Betriebe, enthalten aber fast nur Name, Adresse und Koordinaten.

Begriffe

In den ProHolz-Systemen sind über die Jahre verschiedene Bezeichnungen für dieselben Dinge entstanden. Damit alle Beteiligten dasselbe meinen, verwendet die Schnittstelle durchgehend diese drei Begriffe:

Der dritte Begriff ist der wichtigste für die Gestaltung: Ansprechpartner, Zitat und Bilder hängen nicht am Betrieb, sondern an seiner Zugehörigkeit zu einem bestimmten Netzwerk. Dieselbe Tischlerei kann im Netzwerk Zirbe mit einem anderen Gesicht und einem anderen Statement auftreten als bei den Holzclusterpartnern.

Herkunft und Aktualität

Die Daten stammen aus zwei Quellen, die bereits heute zusammenlaufen:

• Stammdaten — Name, Adresse, Kontakt, Koordinaten, Netzwerkzuordnungen — kommen aus der zentralen ProHolz-Datenbank, in der Simon und das Team pflegen.
• Redaktionelle Inhalte — Beschreibungstexte, Ansprechpartner, Zitate, Bildergalerien, Innovationen — werden separat gepflegt und den Stammdaten zugeordnet.

Die Schnittstelle liefert beides zusammengeführt. Jede Antwort enthält im Feld syncedAt den Zeitpunkt, zu dem die Stammdaten zuletzt übernommen wurden.

Ein neu angelegtes Netzwerk erscheint auf demselben Weg. Wird die Navigation der Website aus /networks aufgebaut, ist dafür keine Änderung am Website-Code nötig — das Netzwerk taucht auf, sobald es in der Datenbank existiert und Betriebe zugeordnet sind.

Authentifizierung

Jeder Konsument erhält einen eigenen Schlüssel, der bei jedem Aufruf im Header X-API-Key mitgeschickt wird.

# Beispielaufruf
curl -H "X-API-Key: <Ihr Schlüssel>" \
     "https://wms.proholz-tirol.at/api/v1/networks"

Getrennte Schlüssel je Konsument haben zwei praktische Gründe: ein Schlüssel lässt sich einzeln tauschen, ohne andere Anbindungen zu stören, und in den Zugriffsprotokollen ist nachvollziehbar, welches System welche Last erzeugt.

Bildabrufe unter /media/ brauchen keinen Schlüssel. Anders ließen sich die Bild-URLs nicht direkt in img-Tags verwenden. Die Bild-URLs sind nicht erratbar-fortlaufend gestaltet, und es sind ohnehin genau die Bilder, die öffentlich angezeigt werden sollen.

Konventionen

Alle Endpunkte antworten mit JSON in UTF-8. Der Basispfad lautet:

https://wms.proholz-tirol.at/api/v1

Jede Antwort ist ein Objekt mit den Nutzdaten unter data. Listen enthalten zusätzlich pagination, alle Antworten syncedAt:

{
  "syncedAt": "2026-08-22T09:00:00+02:00",
  "pagination": { "page": 1, "perPage": 100, "total": 63, "totalPages": 1 },
  "data": [ … ]
}

Felder ohne Wert werden als null geliefert, nicht weggelassen — die Struktur einer Antwort ist damit unabhängig vom Füllstand des einzelnen Datensatzes.

Textfelder, die redaktionell erfasst wurden, enthalten HTML (Absätze, Listen, Links). Sie sind serverseitig aus einer vereinfachten Auszeichnungssprache erzeugt und können unverändert ausgegeben werden. Betroffen sind description beim Betrieb sowie description und contactStatement bei der Netzwerkzugehörigkeit.

Listen sind seitenweise abrufbar über page und perPage (Standard 100, Maximum 500). Mit fields lässt sich die Antwort auf die tatsächlich benötigten Felder eindampfen, was bei Listenansichten spürbar Datenvolumen spart:

/companies?network=55&fields=id,name,city,logoUrl,homepageUrl

Maschinenlesbare Fassung

Diese Beschreibung liegt zusätzlich als OpenAPI-3.1-Datei vor:

openapi.yaml

Damit lassen sich die Endpunkte in Werkzeuge wie Postman oder Insomnia importieren und Clients generieren. Die Datei hat denselben Stand wie diese Seite.

Eine interaktive Oberfläche zum Ausprobieren der Aufrufe folgt, sobald die Schnittstelle tatsächlich erreichbar ist. Solange sie nur beschrieben ist, hätte ein Testaufruf nichts, wogegen er laufen könnte.

Endpunkte

Sieben Endpunkte, alle lesend. Der erste ist der empfohlene Einstiegspunkt.

{
  "syncedAt": "2026-08-22T09:00:00+02:00",
  "data": [
    {
      "id": 55,
      "name": "Holzclusterpartner",
      "companyCount": 130,
      "categories": [
        { "id": 56, "name": "Forstwirtschaft", "companyCount": 9 },
        { "id": 59, "name": "Zimmereien",     "companyCount": 24 }
      ]
    },
    {
      "id": 69,
      "name": "Netzwerk Zirbe",
      "companyCount": 63,
      "categories": [ … ]
    }
  ]
}

Betriebe eines Netzwerks

# Alle Zirbe-Betriebe, auf Listenfelder reduziert
/networks/69/companies?fields=id,name,city,logoUrl,homepageUrl

# Nur die Zimmereien im Holzcluster
/networks/55/companies?category=59

Betriebe suchen

# Zirbe-Betriebe mit Website, im Kartenausschnitt Tirol
/companies?network=69&hasHomepage=true&bbox=10.0,46.6,13.0,47.8

# Suche über zwei Netzwerke hinweg
/companies?network=55&network=69&q=Zimmerei

Ein Betrieb im Detail

{
  "syncedAt": "2026-08-22T09:00:00+02:00",
  "data": {
    "id": 491,
    "name": "Feldkircher GmbH",
    "description": "<p>In unserer Manufaktur entstehen …</p>",
    "street": "Dr. Walter-Zumtobel-Straße 3",
    "zipcode": "6850",
    "city": "Dornbirn",
    "country": "Österreich",
    "latitude": 47.433591,
    "longitude": 9.746341,
    "phone": "+43 5572 58356",
    "email": "info@hubert-feldkircher.at",
    "homepage": "www.hubert-feldkircher.at",
    "homepageUrl": "http://www.hubert-feldkircher.at",
    "logoUrl": "https://wms.proholz-tirol.at/api/v1/media/logo/19163",
    "numberEmployees": null,
    "trainees": false,
    "memberships": [
      {
        "id": 2617,
        "networkId": 69,
        "networkName": "Netzwerk Zirbe",
        "categoryId": 73,
        "categoryName": "Tischler & Innenraumgestaltung",
        "entryDate": null,
        "description": null,
        "contactName": "Hubert Feldkircher",
        "contactFunction": "Geschäftsinhaber und Tischlermeister",
        "contactStatement": "<p>Massivholzmöbel, versehen mit …</p>",
        "contactImageUrl": "…/api/v1/media/photo/ct-2617",
        "images": [
          { "id": "ba-102", "url": "…/api/v1/media/photo/ba-102",
            "title": null, "copyright": null }
        ]
      }
    ],
    "innovations": []
  }
}

Bilder

Alle Bild-URLs stehen fertig und vollständig in den Datensätzen — sie müssen nicht selbst zusammengesetzt werden. An jede dieser URLs lassen sich Parameter zur Größenanpassung anhängen.

<!-- Logo, auf 240 px Breite, ohne Beschnitt -->
<img src="…/api/v1/media/logo/19163?w=240" alt="Feldkircher GmbH">

<!-- Galeriebild als quadratische Kachel -->
<img src="…/api/v1/media/photo/ba-102?w=600&h=600&fit=cover" alt="">

Skalierte Fassungen werden serverseitig zwischengespeichert. Der erste Abruf einer neuen Größe dauert daher etwas länger als die folgenden.

Feldkatalog

Alle Felder eines Betriebs, mit ihrem tatsächlichen Befüllungsgrad. Die Angaben beziehen sich auf die kuratierten Netzwerke, nicht auf den Gesamtbestand — dort liegen die Werte durchweg niedriger.

Der Befüllungsgrad ist der praktisch wichtigste Teil dieser Beschreibung: mehrere Felder existieren technisch, sind aber redaktionell leer. Eine Gestaltung, die auf ihnen aufbaut, würde derzeit ins Leere laufen.

Betrieb

Netzwerkzugehörigkeit

Fehler

Fehler kommen als JSON mit passendem HTTP-Status:

{
  "error": {
    "code": "invalid_parameter",
    "message": "Parameter 'bbox' ist nicht im Format minLng,minLat,maxLng,maxLat."
  }
}

Das Anfragelimit ist großzügig bemessen und wird bei üblicher Nutzung — auch bei serverseitigem Zwischenspeichern der Antworten — nicht erreicht.

Anhang: die bestehenden Schnittstellen

Dieser Abschnitt dient der Einordnung und beschreibt, was heute in Betrieb ist. Für die Anbindung der neuen Website ist er nicht erforderlich.

Die bestehende Darstellung stammt aus zwei Generationen. Die Kartenanwendung von 2012 wurde später durch eine überarbeitete Fassung abgelöst, die bis heute läuft und als eingebetteter Rahmen in die Website eingebunden ist. Sie versorgt sich aus einer älteren Schnittstelle derselben Datenbasis.

Diese bestehenden Zugänge bleiben unverändert bestehen. Die hier beschriebene Schnittstelle ist bewusst getrennt davon aufgebaut — so kann die neue Website entwickelt werden, ohne die laufenden Einbindungen zu berühren, und Erweiterungen für die neue Website können vorgenommen werden, ohne den Bestand zu gefährden.

Zwei Unterschiede zum Bestand sind erwähnenswert, weil sie dort Reibung erzeugt haben:

• Vollständige Bild-URLs. Im Bestand werden Logo-Adressen unvollständig ausgeliefert und müssen vom Empfänger ergänzt werden. Die neue Schnittstelle liefert durchgehend vollständige URLs.
• Freie Größenanpassung. Im Bestand gibt es vier fest vorgegebene Bildgrößen und für Logos gar keine. Die neue Schnittstelle nimmt Breite, Höhe und Zuschnittverhalten als Parameter entgegen.

Offene Punkte

Drei Punkte sind noch abzustimmen, bevor die Umsetzung beginnt:

1. Umfang der Darstellung. Ob Logos, Beschreibungstexte und Ansprechpartner angezeigt werden sollen, entscheidet ProHolz intern. Die Schnittstelle liefert alles; die Entscheidung wirkt sich nur auf die Website aus — und darauf, welche redaktionelle Arbeit sich lohnt.
2. Redaktionelle Nachpflege. Die Beschreibungstexte sind praktisch leer, die Ansprechpartner nur vereinzelt gepflegt. Wenn diese Inhalte Teil der neuen Darstellung sein sollen, ist das ein redaktionelles Vorhaben und kein technisches — die Felder stehen bereit.
3. Die beiden lückenhaften Netzwerke. Bei Design in Tirol und Netzwerk HolzBauPlanung fehlen überwiegend die Websites der Betriebe.

Rückmeldungen zu dieser Beschreibung — fehlende Felder, zusätzliche Filter, andere Zuschnitte — gerne direkt an MINDSTREAM. Änderungen am Zuschnitt sind zu diesem Zeitpunkt unproblematisch; nach Beginn der Frontend-Arbeit werden sie aufwendiger.