Registerabfrage REST Spezifikation v0.03
Bundesministerium für Land- und Forstwirtschaft, Klima- und Umweltschutz, Regionen und Wasserwirtschaft (BMLUK)
Stubenbastei 5, 1010 Vienna, Austria
- Einleitung
- Rechtsgrundlage
- Zugangspunkte
- Authentifizierung
- Request-Parameter
- Response-Parameter
- Codelisten
- Kontakt
- Definitionen und Referenzen
- Spezifikations-Änderungsverzeichnis
Einleitung
Disclaimer
QUERY_REG_PUBLIC v0.03 DRAFT Copyright (C) 2026 Environment Agency Austria Commissioned by the Austrian Federal Ministry of Environment (BMLUK) Contact: edm-helpdesk@umweltbundesamt.at Licensed under the EUPL, Version 1.2 or – as soon they will be approved by the European Commission – subsequent versions of the EUPL (the "Licence"); You may not use this work except in compliance with the Licence. You may obtain a copy of the Licence at: http://joinup.ec.europa.eu/software/page/eupl Unless required by applicable law or agreed to in writing, work distributed under the licence is distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licence for the specific language governing permissions and limitations under the Licence.
Kontext
Das EDM, das Elektronische Daten-Management in der Umwelt- und Abfallwirtschaft, ermöglicht es, Meldeverpflichtungen und Registrierungsverpflichtungen im Umwelt- und Abfallbereich elektronisch abzuwickeln.
Am EDM Anwendungsportal https://edm.gv.at steht neben zahlreichen weiteren Anwendungen die zentrale EDM-Komponente ZAReg für die Verwaltung und Abfrage von Stammdaten zur Verfügung.
Gegenstand der Schnittstelle
Über das Registerabfrage-Webservice können öffentlich verfügbare Daten über im EDM registrierte juristische und natürliche Personen und deren Standorte abgefragt werden.
Es werden Registrierte und Standorte anhand der im Request übergebenen Parameter gesucht, wobei nur die freigegebenen Datensätze von ordentlich Registrierten berücksichtigt werden.
Zielgruppe
Die Schnittstellenbeschreibung richtet sich in erster Linie an IT-Analytiker und Entwickler, die mit der Entwicklung eines Webservice-Clients befasst sind. Zusätzlich kann sie auch von Umwelt- und Abfallwirtschaft Fachpersonal genutzt werden, um genauen Aufschluss über Art und Struktur der über die Schnittstelle abrufbaren Daten zu erlangen.
Rechtsgrundlage
[AWG 2002], idgF
Zugangspunkte
Testsystem: https://test.umweltbundesamt.at/zaregServices-ws/public/solr/registerabfrage
Produktion: https://edm.gv.at/zaregServices-ws/public/solr/registerabfrage
Authentifizierung
Der Webservice-Client muss bei jeder Webservice-Interaktion mittels Client-ID und Client-Secret einen Nachweis über seine Identität per ‘Basic’ HTTP Authentication erbringen.
Für das [HTTP Basic Auth] Schema lautet der spezielle Aufbau:
Authorization: Basic <credentials>
Dabei bildet der Webservice-Client die <credentials> Zeichenkette wie folgt:
Zusammensetzen der folgenden 3 Zeichenketten:
Client-ID
Die aus einem einzelnen Zeichen, dem Doppelpunkt, bestehende Zeichenkette (»
:«, 0x3A)Client-Secret
Aus der zusammengesetzten Zeichenkette mittels [UTF-8] Zeichenkodierung eine Bytefolge berechnen;
Auf die Bytefolge [Base64]-Kodierung anwenden, und zwar jene Variante der [Base64]-Kodierung, welche die Zeichen »+« und »/« für die Indexwerte 62 und 63 nutzt, und sogenanntes Padding anwendet, sodass die Länge der resultierenden Zeichenkette ein Vielfaches von 4 ist.
Beispiel: Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Request-Parameter
Siehe Request-Parameter Definition unter “Parameters” im Swagger UI: https://edm.gv.at/zaregServices-ws/swagger-ui/index.html#/registerabfrage-solr-controller/searchRegisterabfrageSolr
Response-Parameter
Siehe Schema unter “Responses” im Swagger UI: https://edm.gv.at/zaregServices-ws/swagger-ui/index.html#/registerabfrage-solr-controller/searchRegisterabfrageSolr
Codelisten
Einige Response-Elemente enthalten Bezüge auf Codelisten-Einträge.
Die Codelisten sind auf https://edm.gv.at unter dem Punkt Zuordnungstabellen abrufbar.
Es steht auch ein Codelisten-Webservice für die maschinelle Abfrage zur Verfügung.
Kontakt
Für Auskünfte zur Schnittstelle steht der EDM Helpdesk zur Verfügung.
Das EDM-Portal https://edm.gv.at enthält die detaillierten Kontaktinformationen zum EDM Helpdesk.
Definitionen und Referenzen
Akronyme
API
Application Programming Interface
BMLUK
Bundesministerium für Land- und Forstwirtschaft, Klima- und Umweltschutz, Regionen und Wasserwirtschaft
EDM
Elektronisches Datenmanagement - Umwelt
GLN
Global Location Number
Ein GS1 Identifikationsschema, das in URV und ZAReg zur Identifikation von Personen und Standorten verwendet wird
REST
Representational State Transfer
Ressourcen-orientierte [HTTP] API
URV
Unternehmensregister für Zwecke der öffentlichen Verwaltung
https://www.statistik.at/datenbanken/unternehmensregister
ZAReg
Zentrales Anlagen- und Personenregister
Teil des EDM
Referenzen
Abfallwirtschaftsgesetz 2002
The Base16, Base32, and Base64 Data Encodings, RFC 4648, IETF Internet Official Protocol Standards
HTTP/1.1
Hypertext Transfer Protocol, RFC 723x, IETF Internet Standard
The 'Basic' HTTP Authentication Scheme, RFC 7617, IETF Internet Standard
Ein schlankes, ressourcenschonendes Datenaustauschformat; ECMA Standard
Open-Source-Suchplattform von Apache
Unicode-Kodierungsform mit variabler Länge, die durch die Verwendung von 8-Bit-Codeeinheiten die Kompatibilität mit ASCII (American Standard Code for Information Interchange) gewährleistet, The Unicode Consortium
Spezifikations-Änderungsverzeichnis
Version | Datum | Beschreibung |
|---|---|---|
0.03 | 2026‑04‑16 | Kleinere Anpassungen nach Besprechung mit Entwicklung am 15.04.2026:
|
0.02 | 2026‑03‑26 | Vereinheitlichung von Request- und Response-Parameter: Englische Bezeichnung der Request-Parameter |
0.01 | 2026‑02‑17 | Initiale Ausarbeitung der Schnittstelle |