Gérer les exceptions

Gérer les exceptions

Les exceptions levées par une méthode web services sont renvoyées au site marchand sous la forme d'un élément XML Fault.

Une exception est renvoyée par exemple lorsque les attributs des objets nécessaires à l'exécution des opérations sont mal formatés.

Exemple :

Une adresse e-mail mal formatée (sans @) lors de la création d'un alias.

L'exception <soap:Fault> contiendra des détails tels que la chaîne d'exception et la source de l'exception.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">   
<env:Header xmlns:env="http://www.w3.org/2003/05/soap-envelope"/>   
<soap:Body>     
<soap:Fault>
	<soap:Code>
	<soap:Value xmlns:ns1="http://www.w3.org/2003/05/soap-envelope">ns1:Sender</soap:Value>
	</soap:Code>
	<soap:Reason>
	<soap:Text xml:lang="en">CreateRequest.customerRequest.billingDetails.email: Adresse email mal formée</soap:Text>
	</soap:Reason>
	<soap:Detail>
	<requestId>43a61cf4-e467-490e-871e-d61604577cb0</requestId>
	</soap:Detail>
</soap:Fault>
</soap:Body>
</soap:Envelope>

Ce mécanisme de gestion des exceptions permet d'identifier et corriger des données dont le format est incorrect avant d'exécuter une opération.