Ausnahmecodes

Wenn der Server eine Ausnahme auslöst, gibt der REST-Webdienst den Ausnahmecode und eine dazugehörige Ausnahmemeldung über das Netzwerk des Clients zurück. Der Ausnahmecode stellt eine allgemeine Fehlerbeschreibung bereit; die Ausnahmemeldung stellt eine spezifischere Angabe der Ursache für die Ausnahme bereit.

Im folgenden Beispiel enthält eine GET-Anforderung an den Geocode-Dienst den falschen GeocodeType „a“.

GET http://10.24.48.217:8082/Geocode/rest
/GeocodeService/geocode.json?mainAddress=
330%20Front%20St.%20W%20TORONTO%20ON%20M5V%203B7
&country=can&geocodeType=a HTTP/1.1  

Der Server gibt den folgenden Fehler zurück:

HTTP/1.1 400 Bad Request
            Server: Apache-Coyote/1.1
            exceptionCode: INVALID_CLIENT_INPUT
            exceptionMsg: Invalid geocodeType value: A
            Date: Wed, 20 Sep 2017 14:33:03 GMT
            Content-Type: application/json
            Content-Length: 99
            Connection: close
            
            {"errors":[{"errorCode":"INVALID_CLIENT_INPUT","errorDescription":"Invalid geocodeType value: A"}]}

Ausnahmecodes (Datentyp = Zeichenfolge)	Beschreibung
REQUIRED_PARAMETER_MISSING	Ein erforderlicher Parameter fehlt.
DATA_NOT_LICENSED	Die Lizenzdatei für ein Adresswörterbuch wurde nicht installiert.
INTERNAL_ERROR	Bei der Geocoding-Engine ist ein allgemeiner Fehler aufgetreten.
MAPMARKER_EXCEPTION	Bei der MapMarker-Geocoding-Engine ist eine allgemeine Ausnahme aufgetreten.
MAPMARKER_FATAL_EXCEPTION	Bei der MapMarker-Geocoding-Engine ist eine schwerwiegende Ausnahme aufgetreten.
INVALID_CLIENT_INPUT	In der Anforderung ist eine ungültige Eingabe aufgetreten.
NO_COUNTRY_SPECIFIED	Das Länderfeld fehlt in der Anforderung.
COUNTRY_NOT_SUPPORTED	Der angeforderte Vorgang wird für das angegebene Land nicht unterstützt.
GEOSTAN_FATAL_EXCEPTION	Bei der GeoStan-Geocoding-Engine ist eine schwerwiegende Ausnahme aufgetreten.