Eine Reihe von Endpunkten für Adressvorschläge und -validierung. Wählen Sie den Integrationspfad, der zu Ihrem Formulardesign passt.
DQE bietet zwei gleichwertige Sätze von API-Endpunkten:
- Legacy WS - die ursprünglichen WS-Endpunkte, weiterhin vollständig unterstützt.
- RESTful - die neueren REST-Endpunkte, empfohlen für neue Integrationen.
Welcher Modus sollte verwendet werden?
- Verwenden Sie den Single-Modus für eine einfache Adress-Autovervollständigung mit einem einzigen Eingabefeld.
- Verwenden Sie den Funnel-Modus, wenn Sie einen geführten Adresseingabeablauf wünschen, meist zuerst Postleitzahl oder Stadt, dann Straße, dann Gebäude- oder Wohnungszusatz.
- Verwenden Sie RNVP / CheckAddress, wenn der Nutzer bereits eine vollständige Adresse eingegeben hat und Sie diese validieren oder korrigieren müssen.
Vor der Implementierung - Lesen Sie den Integrationsleitfaden → Er behandelt gängige Muster, Sonderfälle und Fallstricke, die für alle Endpunkte gelten. Dringend empfohlen.
Voraussetzung - Das Feld
country muss mit dem erwarteten Ländercode (dreistelliger ISO-Code) angegeben werden. Vorschlag Wählen Sie einen Ansatz je nach Ihrem Formulardesign
Einzeilig
Ein Freitext-Eingabefeld. Der Nutzer tippt frei; DQE liefert Vorschläge in Echtzeit.
Schrittweise
Strukturierte Felder. Jeder Schritt grenzt die Adresse Schritt für Schritt weiter ein.
Validierung Alle Eingabefälle absichern - Aufruf nach Freitexteingabe oder geändertem Vorschlag
CHECKADDRESS
/RNVP/ · REST: /checkaddress/
Strukturiert eine vollständige Adresse neu, validiert und normalisiert sie.
Um zu prüfen, welche Länder und Adressfunktionen unterstützt werden, siehe Address Coverage →
Integrationsabläufe
Single-Modus - /SINGLEV2/ → /COMPLV2/
Funnel-Modus - /CP/ → /ADR/ → /COMPL/
RNVP / CheckAddress - /RNVP/
Verknüpfung mit