Address API - Eine Adresse prüfen und verifizieren (Classic)

Support DQE

Aktualisiert 26. September 2026 00:02

Validierung - Standard-API

Validiert und normalisiert eine vollständige Adresse. Liefert eine korrigierte Adresse, ein Zustellbarkeitsurteil (DQECodeDetail) und optional eine Aufstellung, welche Felder angepasst wurden.

Wann diesen Endpunkt aufrufen? - RNVP ist der Validierungsschritt der Stufe 2. Lösen Sie ihn aus, wenn der Nutzer eine Adresse frei eingibt oder einen DQE-Vorschlag vor dem Absenden ändert. Hat der Nutzer einen DQE-Vorschlag unverändert übernommen, ist die Qualität bereits gewährleistet - kein Aufruf nötig.

Anfrage

Sowohl GET als auch POST werden unterstützt.

{SERVER_ADDRESS} und {LICENCE_CODE} werden von DQE bei der Kontoeröffnung bereitgestellt. Wenden Sie sich an Ihren DQE-Ansprechpartner, um diese Zugangsdaten zu erhalten.

Die Adresseingabe muss URL-kodiert sein - z. B. l'église → l%27%C3%A9glise.

GETPOST

GEThttps://{SERVER_ADDRESS}/RNVP/?Adresse={INPUT}&Pays={COUNTRY_CODE}&Licence={LICENCE_CODE}

cURL-Beispiele

Frankreich - mit Modification=O und Version=1.1

curl "https://{SERVER_ADDRESS}/RNVP/?Adresse=%7C1%20rue%20de%20la%20louisiane%7C%7C31200%7Ctoulouse&Pays=FRA&Taille=38&Modification=O&Version=1.1&Licence={LICENCE_CODE}"

International - Italien

curl "https://{SERVER_ADDRESS}/RNVP/?Adresse=%7CSTRADA%20BARDONEY%7C%7C11028%7CVALTOURNENCHE&Pays=ITA&Taille=38&Licence={LICENCE_CODE}"

POSThttps://{SERVER_ADDRESS}/RNVP/

Senden Sie alle Parameter im Anfragetext mit Content-Type: application/x-www-form-urlencoded. Die Serveradresse bleibt in der URL.

cURL-Beispiel

Frankreich - vollständige Adresse mit Modification-Flag

curl -X POST "https://{SERVER_ADDRESS}/RNVP/" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "Adresse=%7C1+rue+de+la+louisiane%7C%7C31200%7Ctoulouse" \
  -d "Pays=FRA" \
  -d "Taille=38" \
  -d "Modification=O" \
  -d "Version=1.1" \
  -d "Licence={LICENCE_CODE}"

Parameter

Parameter	Wert	Beschreibung	Pflicht / Opt.
Licence	`{LICENCE_CODE}`	Ihr DQE-Lizenzschlüssel oder OAuth2-Token. Wenden Sie sich an den Support, falls Sie noch keinen haben.	Pflicht
Adresse	`{INPUT}`	Durch Pipes getrennte Adresszeichenkette. Alle fünf Pipes sind Pflicht, auch wenn Felder leer sind. Für Frankreich kann ein sechstes Segment für die Zustellstelle (Wohnung, Stockwerk, Briefkasten) vorangestellt werden. Adresszusatz\|Adresse\|Ortsteil oder Bundesstaat\|Postleitzahl\|Ort Beispiel: `\|1 rue de la louisiane\|\|31200\|toulouse`	Pflicht
Pays	`{COUNTRY_CODE}`	Ländercode nach ISO 3166-1 alpha-3 für den Suchbereich der Adresse. Beispiel: `FRA` oder `GBR`.	Pflicht
Taille	`{LENGTH}`	Zeichenlimit für das Antwortfeld `Adresse`. Gilt nur für Adressen in lateinischer Schrift. Standard: `38`. Empfohlenes Minimum: `32`.	Optional
Instance	`{INSTANCE}`	Wird bei diesem Endpunkt nicht in den Ergebnissen zurückgegeben - kann weggelassen werden.	Optional
Proposition	`{PROP}`	Nur Frankreich. Steuert, wie Korrekturergebnisse zurückgegeben werden. `O` - Datensatz `"1"` enthält das Standard-Korrekturergebnis. Kann die Adresse nicht eindeutig zugeordnet werden, werden weitere Vorschläge als Datensätze `"2"` bis `"n"` zurückgegeben. `S` - Datensatz `"1"` gibt die Eingabeadresse unverändert mit ihrem Validierungsstatus zurück (nicht korrigiert). Wird eine eindeutige Korrektur gefunden, wird sie als Datensatz `"2"` zurückgegeben. Aktiviert automatisch `Modification=O`.	Optional
Modification	`O`	Fester Wert `O`. Fügt der Antwort `Code_Modification` und `Status_Modification` hinzu, die angeben, welche Adressfelder angepasst wurden (Adresszusatz, Adresse, Ortsteil, Postleitzahl oder Ort). Siehe Code_Modification.	Optional
Version	`{VERSION}`	`1.1` - Fügt der Antwort Felder zur Geokodierungsqualität hinzu (`LibelleQualiteGeo`, `CodeQualiteGeo`) (nur Frankreich, Abonnement erforderlich - wenden Sie sich zur Aktivierung an Ihren DQE-Ansprechpartner). `2` - Gibt zusätzliche Adressdaten im Feld `ListeComplement` zurück.	Optional
Segmentation	`O`	Nur Frankreich. Finesis-Abonnement erforderlich - wenden Sie sich zur Aktivierung an Ihren DQE-Ansprechpartner. Auf `O` setzen, um der Antwort `Sprofil`, `Sportrait` und `Ssegment` (Felder zur Bevölkerungssegmentierung) hinzuzufügen. Standard: `N`.	Optional

Antwortfelder

Die Antwort ist ein JSON-Objekt mit einem einzigen Schlüssel "1", dessen Wert ein Wörterbuch mit Adressfeldern ist. Bei Proposition=O können mehrere nummerierte Datensätze zurückgegeben werden.

Zusatzfelder - Die Validierung erfolgt bis zur Hausnummer. Wird ein Zusatz übermittelt (Gebäudename, Stockwerk usw.), der einem referenzierten Zusatz entspricht, ergänzt die Engine ihn um den vollständigen registrierten Namen. Wird kein Zusatz übermittelt, wird die vollständige Liste der verfügbaren Zusätze zurückgegeben (durch Semikolons getrennt). Nicht erkannte Zusätze werden unverändert zurückgegeben.

Groß-/Kleinschreibung der Ausgabe - Die Schreibweise folgt der Postnorm des jeweiligen Landes.

Schlüssel	Beschreibung	Frankreich	International
DQECodeDetail	Code des Validierungsergebnisses. Siehe DQECodeDetail-Codes weiter unten.	String (2)	String (2)
DQELibErreur	Klartext-Bezeichnung des Validierungsergebnisses (`OK` oder eine Fehlerbeschreibung).	String (38)	String (38)
Adresse	Normalisierte Adresszeile (Hausnummer, Straßentyp und -name).	String (38)	String (50)
Voie	Straßenname ohne Nummer und Typ. Ausnahme: Ist der Straßentyp als zusammengesetztes Wort im Straßennamen enthalten (z. B. `Tannenburgweg`), wird hier der vollständige Name zurückgegeben und `TypeVoie` ist leer.	String (38)	String (50)
TypeVoie	Straßentyp (z. B. `RUE`, `AVENUE`, `BOULEVARD`). Leer, wenn der Straßentyp als zusammengesetztes Wort im Straßennamen enthalten ist (in diesem Fall wird der vollständige Name in `Voie` zurückgegeben).	String (20)	String (20)
Numero	Vollständige Hausnummer einschließlich Zusatz (bis, ter usw.).	String (10)	String (10)
NumSeul	Nur die Hausnummer, ohne Zusatz (bis, ter usw.).	String (10)	String (10)
CompNum	Hausnummernzusatz (bis, ter usw.).	String (38)	String (50)
NbNumero auch: Nbnumero	Wenn die abgefragte Nummer nicht gefunden wurde oder fehlt, wird die Gesamtzahl der gültigen Hausnummern dieser Straße zurückgegeben. Kann bei manchen internationalen Adressen, für die diese Daten nicht verfügbar sind, eine leere Zeichenkette sein.	String	String
ListeNumero	Durch Semikolons getrennte Liste aller gültigen Nummern dieser Straße. Befüllt, wenn die übermittelte Nummer ungültig ist oder fehlt.	String (1024)	String (1024)
CodePostal	Postleitzahl.	String (5)	String (10)
Localite	Ortsname.	String (38)	String (50)
LieuDit	Flurname oder Weiler (Frankreich) bzw. entsprechendes Feld auf Bezirksebene (international). Die Verfügbarkeit variiert je nach Land.	String (38)	String (50)
Cedex	CEDEX-Indikator: `1` = CEDEX-Adresse, `0` = kein CEDEX.	String (1)	String (1)
Ligne2	Zusätzliche Informationen aus Adresszeile 2.	String (38)	String (38)
Complement	Zusätzliche Adressinformationen (Gebäudename, Stockwerk usw.).	String (1024)	String (150)
ListeComplement	Durch Semikolons getrennte Liste der verfügbaren Adresszusätze (Gebäude, Wohnanlagen usw.) für die gefundene Straße. Wird bei `Version=2` zurückgegeben.	String (1024)	String (1024)
IDLocalite	Eindeutige Ortskennung (INSEE-Code für Frankreich).	String (20)	String (20)
IDVoie oder CodeVoie	Eindeutige Straßenkennung.	String (20)	String (20)
Pays	Ländercode nach ISO 3166-1 alpha-3.	String (3)	String (3)
Province	ISO-Code des Bundesstaats bzw. der Verwaltungsregion.	Immer `"*"`	String (50)
Region1	Bezeichnung des Bundesstaats bzw. der Region.	Nicht verfügbar	String
Region2	Landkreis oder gleichwertige Verwaltungsebene.	Nicht verfügbar	String
Region3	Landkreis oder Gleichwertiges (alternative Ebene).	Nicht verfügbar	String
Region4	Zusätzliche regionale oder administrative Informationen.	Nicht verfügbar	String
Thoroughfare	Abhängige Straße.	Nicht verfügbar	Nur UK
Roudis	Roudis-Leitcode. Nur Frankreich.	String (5)	Nicht verfügbar
IDHexaposte	Postalische Ortskennung (Hexaposte-Code für Frankreich).	String (6)	Nicht verfügbar
IDCle	Eindeutige Hausnummernkennung (Hexaclé für Frankreich).	String (10)	Nicht verfügbar
Latitude	Geokoordinaten der gefundenen Adresse. Nicht für alle Länder verfügbar - siehe Abdeckung.	String	String
Longitude	Geokoordinaten der gefundenen Adresse. Nicht für alle Länder verfügbar - siehe Abdeckung.	String	String
Status_IrisIlot	Herkunft der IRIS- und Ilot-Codes. Abonnement erforderlich - wenden Sie sich zur Aktivierung an Ihren DQE-Ansprechpartner.	String (5)	Nicht verfügbar
iris	Code der statistischen Einheit IRIS. Nur Frankreich, Abonnement erforderlich - wenden Sie sich zur Aktivierung an Ihren DQE-Ansprechpartner.	String (9)	Nicht verfügbar
ilot	Ilot-Code. Abonnement erforderlich - wenden Sie sich zur Aktivierung an Ihren DQE-Ansprechpartner.	String	Nicht verfügbar
Instance	Internes Feld.	String (3)	String (3)
LibelleQualiteGeo	Bezeichnung der Geokodierungsqualität (z. B. `ENTREE`, `BATIMENT`). Befüllt bei `Version=1.1`. Siehe Geokodierungsqualität.	String	Nicht verfügbar
CodeQualiteGeo	Numerischer Code der Geokodierungsqualität. Befüllt bei `Version=1.1`.	String	Nicht verfügbar
Sprofil	Bevölkerungsprofil (Finesis). Wird bei `Segmentation=O` zurückgegeben.	String (10)	Nicht verfügbar
Sportrait	Bevölkerungsporträt (Finesis). Wird bei `Segmentation=O` zurückgegeben.	String (10)	Nicht verfügbar
Ssegment	Bevölkerungssegment (Finesis). Wird bei `Segmentation=O` zurückgegeben.	String (10)	Nicht verfügbar
Code_Modification	5-stellige Binärzeichenkette, die angibt, welche Adressfelder angepasst wurden. Wird bei `Modification=O` zurückgegeben. Siehe Code_Modification.	String (5)	String (5)
Status_Modification	`O`, wenn mindestens ein Feld angepasst wurde, sonst `N`. Wird bei `Modification=O` zurückgegeben.	String (1)	String (1)
DQECompte DQECodeErreur DQEPourcentErreur	Veraltete Felder, die aus Gründen der Abwärtskompatibilität mit alten Integrationen beibehalten werden. Nicht in neuen Implementierungen verwenden.	String	Nicht verfügbar

Zurückgegeben mit Version=1.1 Zurückgegeben mit Segmentation=O Zurückgegeben mit Modification=O

Antwortbeispiele

|1 Rue de la Louisiane||31200|Toulouse

{
  "1": {
    "Roudis": "4221",
    "DQECompte": "",
    "Instance": "",
    "CodePostal": "31200",
    "Status_IrisIlot": "INSEE",
    "Latitude": "43.634746",
    "Localite": "TOULOUSE",
    "Province": "*",
    "NbNumero": "0",
    "Complement": "BATIMENT D RESIDENCE ALLEE DES CEDRES;BATIMENT A RESIDENCE ALLEE DES CEDRES;BATIMENT B RESIDENCE ALLEE DES CEDRES;BATIMENT C RESIDENCE ALLEE DES CEDRES",
    "Voie": "DE LA LOUISIANE",
    "Adresse": "1 RUE DE LA LOUISIANE",
    "Cedex": "",
    "Numero": "1",
    "ListeNumero": "",
    "IDHexaposte": "14411",
    "IDCle": "3155526YEA",
    "Nbnumero": "0",
    "LieuDit": "",
    "ilot": "",
    "TypeVoie": "RUE",
    "DQECodeDetail": "10",
    "DQELibErreur": "OK",
    "Longitude": "1.430098",
    "CompNum": "",
    "iris": "3701",
    "IDLocalite": "31555",
    "DQECodeErreur": "0",
    "Pays": "FRA",
    "IDVoie": "2408474",
    "NumSeul": "1",
    "Ligne2": "",
    "DQEPourcentErreur": "0" }
}

DQECodeDetail-Codes

DQECodeDetail ist der primäre Indikator für das Validierungsergebnis. Verwenden Sie ihn, um zu bestimmen, welche Aktion beim Absenden des Formulars erfolgen soll.
Empfohlene UI-Meldungen für jeden Code finden Sie im Integrationsleitfaden.

Code	Beschreibung
10	Korrekte Adresse
20	Korrekte Adresse (Straße nicht erkannt, aber es handelt sich um eine CEDEX-Adresse oder ein Postfach)
21	Kleiner Ort, Hausnummer außerhalb des gültigen Bereichs
22	Kleiner Ort, Hausnummer fehlt (der Rest der Adresse ist korrekt)
23	Große Stadt, Hausnummer außerhalb des gültigen Bereichs
24	Große Stadt, Hausnummer fehlt (der Rest der Adresse ist korrekt)
25	CEDEX-Adresse in CEDEXA unbekannt (falls CEDEXA aktiv ist)
30	Kleiner Ort, Straße nicht erkannt
31	Kleiner Ort - Straße nicht erkannt oder fehlend; Ortsteil-Information erkannt, reicht aber nicht aus, um die Straße zu bestimmen. Nur Frankreich.
40	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.
41	Kleiner Ort, Straße fehlt
50	Große Stadt, Straße nicht erkannt
51	Große Stadt, Straße nicht erkannt oder fehlend (Ortsteil-Information erkannt, reicht aber nicht aus, um die Straße zu bestimmen). Nur Frankreich.
60	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.
61	Große Stadt, Straße fehlt
70	Postleitzahl und Ort passen nicht zusammen - Straße vorhanden
71	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.
80	Postleitzahl und Ort passen nicht zusammen - Straße fehlt
81	Eingabeadressblock leer. Wird für Frankreich nicht zurückgegeben.
90	Internationale Adresse erkannt - der eingegebene Ländercode scheint nicht zur eingegebenen Adresse zu passen.
95	Ländercode fehlt oder ist falsch

Kleiner Ort vs. große Stadt - In Frankreich gilt ein Ort als groß, wenn er mehr als 2 500 Einwohner hat. International liegt die Schwelle bei 500 Straßen. Diese Unterscheidung bestimmt, ob die Codes für kleine Orte (21, 22, 30, 31, 41) oder für große Städte (23, 24, 50, 51, 61) gelten.

Ortsteil - Die Codes 31 und 51 zeigen an, dass ein Ortsteil erkannt wurde: ein von der Engine identifiziertes geografisches Gebiet (z. B. ein Weiler oder eine Wohnsiedlung), das keiner bestimmten Straße zugeordnet werden kann. Diese Codes gelten nur für Frankreich.

DQECodeDetail - Eingabebeispiele

Beispieleingaben, die den jeweiligen Code erzeugen. Nicht aufgeführte Felder bleiben leer.

Code	Frankreich	International
10	`\|20 rue Jean-Baptiste Pigalle\|\|75009\|Paris`	`Albert Buildings\|3 Scott Drive\|\|WA15 8AB\|ALTRINCHAM` GBR
20	`\|RUE DES FRERES LUMIERE\|BP 30036\|33564\|CARBON BLANC`	-
21	`\|26 route du chardonnay\|\|24130\|Ginestet`	`\|Seulestraat 200\|\|8950\|Heuvelland` BEL
22	`\|route du chardonnay\|\|24130\|Ginestet`	`\|Seulestraat\|\|8950\|Heuvelland` BEL
23	`\|13 rue Jean-Baptiste Pigalle\|\|75009\|Paris`	`\|Rue Victor Hugo 235\|\|7012\|Mons` BEL
24	`\|rue Jean-Baptiste Pigalle\|\|75009\|Paris`	`\|Rue Victor Hugo\|\|7012\|Mons` BEL
25	`\|\|\|82016\|Montauban CEDEX`	-
30	`\|rue Jean-Baptiste Pigalle\|\|24130\|Ginestet`	`\|Via del lungo\|\|70011\|Alberobello` ITA
31	`\|SAINT SYMPHORIEN\|\|12490\|VIALA DU TARN`	Außerhalb Frankreichs nicht zurückgegeben
40	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.
41	`\|\|\|24130\|Ginestet`	`\|\|\|70011\|Alberobello` ITA
50	`\|route du chardonnay\|\|75009\|Paris`	`\|STREET ABCD\|\|60607\|CHICAGO` USA
51	`\|Lotissement Casella\|\|20243\|PRUNELLI DI FIUMORBO`	Außerhalb Frankreichs nicht zurückgegeben
60	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.
61	`\|\|\|75009\|Paris`	`\|\|\|60607\|CHICAGO` USA
70	`\|rue de la mairie\|\|75009\|Bordeaux`	`\|FRANKLIN GTWY SE\|\|00067\|MARIETTA` USA
71	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.	In aktuellen Cloud-Bereitstellungen nicht zu erwarten. Aus Kompatibilitätsgründen definiert.
80	`\|\|\|75009\|Bordeaux`	`\|\|\|00067\|MARIETTA` USA
81	Für Frankreich nicht zurückgegeben	`\|\|\|\|`
90	`\|7C avenue Monbijou\|\|4960\|Malmedy` Pays: FRA - Adresse scheint nicht französisch zu sein	-
95	-	-

Code_Modification

Wird zurückgegeben, wenn der Anfrage Modification=O hinzugefügt wird. Status_Modification ist O, wenn ein Feld angepasst wurde, sonst N. Code_Modification ist eine 5-stellige Binärzeichenkette mit einer Position pro Adressfeld. 1 = von DQE angepasst, 0 = unverändert.

Adresszusatz|Adresse|Ortsteil|Postleitzahl|Ort

Code_Modification	Bedeutung
`00000`	Keine Felder angepasst - Adresse wie übermittelt akzeptiert.
`11111`	Alle fünf Felder angepasst.
`00011`	Postleitzahl und Ort angepasst; übrige Felder unverändert.
`01111`	Adresse, Ortsteil, Postleitzahl und Ort angepasst; Adresszusatz unverändert.
`10000`	Nur Adresszusatz angepasst.
`01000`	Nur Adresszeile angepasst.
`00100`	Nur Ortsteil angepasst.

Tipp - Ist Status_Modification gleich O, wurde mindestens ein Feld von DQE geändert. Zeigen Sie dem Nutzer die Korrektur in einem Popup an und lassen Sie ihm stets die Möglichkeit, seine ursprüngliche Eingabe beizubehalten.

Geokodierungsqualität

Wenn Version=1.1 gesetzt und die Geokodierung abonniert ist, werden zwei Felder hinzugefügt: LibelleQualiteGeo (Bezeichnung) und CodeQualiteGeo (numerischer Code). Nur Frankreich.

Code	LibelleQualiteGeo	Beschreibung
1	ENTREE	Hauptzugang zu einem Grundstück, einer Gebäudegruppe oder einer Parzelle (Hausnummernschild).
2	BATIMENT	Gebäude oder Gebäudeteil.
3	ESCALIERS	Treppenhaus, normalerweise innerhalb eines Gebäudes.
4	LOGEMENT	Wohnung oder Raum innerhalb eines Gebäudes.
5	PARCELLE CADASTRALE	Katasterparzelle.
6	SEGMENT DE VOIE	Aus dem angrenzenden Straßenabschnitt abgeleitete Position. Kann außerhalb des Ortspolygons, aber auf derselben Straße liegen.
7	POINT D ACCESS TECHNIQUE	Technischer Zugangspunkt (Absperrung für Wasser, Strom, Gas usw.).
8	POINT DELIVRANCE POSTALE	Postalische Zustellstelle (Briefkasten).
9	ZONE D ADRESSAGE	Im Ortsteil platzierter Punkt.
10	CENTRE VILLE	Ortsmitte.
0	CENTRE DE LA VOIE	Punkt in der Mitte der Straße.
90	A CONTROLER	Geokodierungsqualität unsicher - zu prüfen.
99	NON PRESENTE	Für diese Adresse ist keine Geokodierung verfügbar.

Fehler

Im Gegensatz zu den Vorschlags-APIs gibt RNVP Standard-HTTP-Fehlercodes zurück (keinen leeren Antworttext), wenn Pflichtparameter fehlen oder ungültig sind.

HTTP	Fehlertyp	Antworttext
400	`Licence` fehlt oder ist leer	`Bad Request Parameters empty fields`
401	Falsche `Licence`	`unauthorized_client`
400	`Adresse` fehlt oder ist leer	`Bad Request Parameters empty fields`
400	`Pays` fehlt oder ist leer	`Bad Request Parameters empty fields`
400	Ungültiger Parameterwert	`Bad Request Parameters empty fields`

API testen

Klicken Sie auf die Schaltfläche unten, um diesen Endpunkt live in Ihrem Browser zu testen.

Konsole öffnen

Siehe auch

Verknüpfung mit

Address
API

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich

Address API - Eine Adresse prüfen und verifizieren (Classic)

Anfrage

cURL-Beispiele

cURL-Beispiel

Parameter

Antwortfelder

Antwortbeispiele

DQECodeDetail-Codes

DQECodeDetail - Eingabebeispiele

Code_Modification

Geokodierungsqualität

Fehler

API testen

Siehe auch

War dieser Beitrag hilfreich?

Vorheriger Artikel

Nächster Artikel