Safe Creative API Web Services Reference v2 - D R A F T

Error handling

Invalid parameters or invalid requests return an error, server-side problems return an exception.

Example of an error:

REQUEST:

https://api.safecreative.org/v2/
?component=authkey.state
&sharedkey=zy9x4ol0ctg3btyswq7b5wi9
&ztime=1271749823276
&signature=c47b33222c850019574185051c3013ee817e5584


RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<error>
  <errorId>RestParameterNotFound</errorId>
  <errorMessage>Required parameter not found: authkey</errorMessage>
</error>

Example of an exception:

REQUEST:

https://api.safecreative.org/v2/?component=exception.test

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<exception>
  <exceptionId>RuntimeException</exceptionId>
  <exceptionMessage>This is a test exception</exceptionMessage>
  <stackTrace></stackTrace>
</exception>

TOC