Informationen zum ÖBf-Webservice
Annahmestelle für Werksabmaßen
Die Österreichischen Bundesforste (ÖBf) bieten ab sofort interessierten Kunden die Möglichkeit der Werksabmaß-Übermittlung (FHPDAT) per REST-Webservice an und wollen damit eine Optimierung des gemeinsamen Datenaustausches vorantreiben.
Die Einrichtung eines Webservices richtet sich an SpezialistInnen. REST ist ein Standard für Webservices im Internet.
Wir ersuchen daher um Verständnis, dass die ÖBf für die Lösung von technischen Problemen im Zusammenhang mit der grundsätzlichen Einrichtung von Webservices nicht zur Verfügung stehen - bei Fragen zum Webservice der ÖBf AG stehen wir natürlich zur Verfügung (Kontakt siehe am Ende dieser Seite). Der Aufruf des Webservices kann aus Programmen auf nahezu jeder Plattform (z.B. Java, zu Testzwecken auch via Postman) erfolgen.
Erfahren Sie nun folgend nähere Details dazu...
- Der/die ÜbermittlerIn muss Kunde der ÖBf AG sein.
- Der/die ÜbermittlerIn muss als AbsenderIn im ÖBf-System registriert sein und benötigt Zugangsdaten zu selbigem (Hotline: 02231/6005050)
- Alle Requests müssen in UTF-8 geschickt werden.
- Es werden (vorerst) nur Abmaßdaten akzeptiert - im XML-Format FHPDAT (SAEGE bzw. IND) (gezippt/ungezippt)
die technische Dokumentation zum Endpunkt https://gateway.bundesforste.at:44300/webservices/ZABMS
entnehmen Sie bitte diesen Seiten:
- GET_csrfToken
- POST_fhpdat_abm (mit dem FHP-Abmaßprotokoll als XML-Stream im Request-Body)
Basic Authentification mit den von ÖBf übergebenen Credentials.
Außerdem muss dem POST-Request ein zeitlich beschränkter CSRF-Token übergeben werden, der unmittelbar davor per GET angefordert wurde (siehe REST API).
kurze Referenz + Erläuterungen zu den möglichen Fehlercodes:
- 204 OK
- Abmaß erfolgreich übermittelt
- 400 Bad Request
- technischer oder inhaltlicher Fehler
- wird auch retourniert, wenn Abmaß inhaltlich nicht FHP-kompatibel ist
- oder Mussfelder fehlen
- inkl. Fehlerbeschreibung im Response-Body
- 401 Unauthorized
- falsche oder abgelaufene Credentials
- 500 Internal Server Error
- ÖBf-System nicht erreichbar
- bitte später nochmals versuchen
Dominik Lepizh
Informationstechnologie-Management
Dominik.Lepizh [AT] bundesforste [.] at
+436648197810
