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 die GET-Anforderung für den Geocode-Dienst das Element „Line“, bei dem es sich um einen falschen Parameter handelt.
GET http://endpoint/Geocode/rest/GeocodeService/geocode.json?
mainAddress=42%20Venus%20Drive&Line=Shrewsbury&country=USA HTTP/1.1 Der Server gibt den folgenden Fehler zurück:
HTTP/1.1 500 Internal Server Error
Server: Apache-Coyote/1.1
Date: Wed, 25 Feb 2015 20:52:18 GMT
exceptionCode: INVALID_CLIENT_INPUT
exceptionMsg: Unknown query parameter Line
Content-Length: 0
Connection: close | 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. |