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. |