API

Gebietszuständigkeiten sicher in eigene Systeme einbinden.

Die API stellt lesende Wege für Standorte und Zuständigkeitsabfragen bereit. Sie arbeitet mit serverseitigen Bearer-Schlüsseln, einer positiven Rechteauswahl und klaren Abrufgrenzen.

API-Dokumentation öffnen
API-Dokumentation mit Zuständigkeitsabfrage
Die Dokumentation zeigt die lesenden Endpunkte und ihre Antwortformen.

Sieben dokumentierte Wege

Lesende Abfragen für eigene Systeme.

Die Schnittstelle verbindet eigene Webauftritte und Prozesse mit der Gebietslogik. Sie ist kein CRM und keine allgemeine Adress- oder Routen-API.

Serverseitige Bearer-Schlüssel

Jeder Abruf authentifiziert sich serverseitig mit einem Bearer-Schlüssel. Ein Schlüssel gehört nicht in den Browser.

Standorte und Gebiete

Standorte, Gebietslisten und räumliche Zuständigkeiten stehen für die Integration zur Verfügung.

Zuständigkeit abfragen

Die Abfrage beantwortet, welcher Standort für eine PLZ, Koordinate oder Adresse zuständig ist – nicht einfach, welcher Standort am nächsten liegt.

POST bleibt eine Abfrage

POST /zustaendigkeit ändert nichts. Er nimmt Adresse oder Koordinate im Request entgegen, damit sie nicht in URL und Zugriffsprotokoll stehen.

Rechte je Schlüssel

Jeder Schlüssel erhält nur die ausdrücklich erlaubten Rechte. Die Buchung begrenzt zusätzlich, welche Daten ausgeliefert werden.

Abrufgrenzen

Antworten unterstützen Caching; bei zu vielen Abrufen schützt eine klar dokumentierte Begrenzung die Schnittstelle.

Sicher einrichten

Dokumentation, Schlüssel und Antwort greifen ineinander.

Die Screens zeigen technische Referenz, Rechteverwaltung und die Zuständigkeitsantwort, die eine Integration tatsächlich benötigt.

01

Endpunkt nachvollziehen

Die Dokumentation beschreibt Anfrage, Antwort, Rechte und Fehlerfälle für jede lesende Abfrage.

API-Dokumentation
Öffentliche API-Dokumentation.
02

Rechte begrenzen

Ein Schlüssel erhält nur die Wege, die seine Integration wirklich benötigt.

API-Schlüssel mit Rechteauswahl
Rechte als Positivliste verwalten.
03

Zuständigkeit ausgeben

Die Adresse liefert einen klaren Treffer mit zuständigem Standort und Gebiet – nicht bloß den nächstgelegenen Standort.

Adressprüfung mit zuständigem Standort
Adressprüfung mit einem eindeutigen Gebietstreffer.

Wichtig

Die API liefert nur Daten, für die der jeweilige Schlüssel und die Buchung berechtigen. Sie ist keine Adressspeicherung, keine Navigation und keine Vertragsverwaltung.

Weiterarbeiten

Endpunkte und Beispiele in der Dokumentation ansehen.

Die vollständige Referenz beschreibt Rechte, Fehlerfälle, Caching und alle verfügbaren Wege.

Zur API-Dokumentation