Códigos de excepción
Si el servidor lanza una excepción, el servicio web REST devolverá el código de excepción y un mensaje de excepción por la red al cliente. El código de excepción ofrece una descripción general del error; el mensaje de excepción entrega una indicación más específica sobre la causa de la excepción.
En el siguiente ejemplo, la solicitud GET realizada al servicio de geocodificación contiene el geocodeType incorrecto “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
El servidor devuelve el siguiente error:
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"}]}
Códigos de excepción (tipo de datos = cadena) | Descripción |
---|---|
REQUIRED_PARAMETER_MISSING | Falta un parámetro obligatorio. |
DATA_NOT_LICENSED | No se ha instalado el archivo de licencia para un diccionario de direcciones. |
INTERNAL_ERROR | Se produjo un error general en el motor de geocodificación. |
MAPMARKER_EXCEPTION | Se produjo una excepción general en el motor de geocodificación MapMarker. |
MAPMARKER_FATAL_EXCEPTION | Se produjo una excepción fatal en el motor de geocodificación MapMarker. |
INVALID_CLIENT_INPUT | Se encontró una entrada no válida en la solicitud. |
NO_COUNTRY_SPECIFIED | Falta el campo de país en la solicitud. |
COUNTRY_NOT_SUPPORTED | No se admite la operación solicitada para el país especificado. |
GEOSTAN_FATAL_EXCEPTION | Se produjo una excepción fatal en el motor de geocodificación GeoStan. |