Codes d'exception
Si le serveur déclenche une exception, le service Web REST renvoie le code d'exception et un message d'exception au client sur le réseau. Le code d'exception fournit une description générale de l'erreur ; le message d'exception fournit une indication plus précise de la cause de l'exception.
Dans l'exemple suivant, une requête GET pour le service Geocode contient « Line », qui est un paramètre incorrect.
GET http://endpoint/Geocode/rest/GeocodeService/geocode.json?
mainAddress=42%20Venus%20Drive&Line=Shrewsbury&country=USA HTTP/1.1 Le serveur renvoie l'erreur suivante :
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 | Exception Codes (datatype = String) | Description |
|---|---|
| REQUIRED_PARAMETER_MISSING | Il manque un paramètre obligatoire. |
| DATA_NOT_LICENSED | Le fichier de licence d'un dictionnaire d'adresses n'est pas installé. |
| INTERNAL_ERROR | Une erreur générale s'est produite avec le moteur de géocodage. |
| MAPMARKER_EXCEPTION | Une exception générale s'est produite avec le moteur de géocodage MapMarker. |
| MAPMARKER_FATAL_EXCEPTION | Une exception fatale s'est produite avec le moteur de géocodage MapMarker. |
| INVALID_CLIENT_INPUT | Une entrée non valide a été rencontrée dans la requête. |
| NO_COUNTRY_SPECIFIED | Le champ country est absent de la requête. |
| COUNTRY_NOT_SUPPORTED | L'opération demandée n'est pas prise en charge pour le pays spécifié. |
| GEOSTAN_FATAL_EXCEPTION | Une exception fatale s'est produite avec le moteur de géocodage GeoStan. |