Exceptions and errors

The server can either throw an exception or return an error. When you use the URL API, and you encounter a problem, you see an error code.

  • The client displays a standard HTTP error if the request to the server fails. For example:
    Error Code
    202 The server received and is processing the request.
    204 The server received the request, but there is no information to return.
    300 The request could not be completed due to an authentication failure.
    404 The specified jobId could not be found.
    500 The server encountered an unexpected condition which prevented it from fulfilling the request.
    These codes appear in the XML that the server returns. For more information on error codes, see the W3C list of HTTP status codes
  • The server returns an error (or warning) if there is an error in the syntax or semantics in the expression or function being passed to the server. These errors are returned as part of the results.

Additionally, if the user submits a request and omits a required parameter, the server returns an appropriate error message as part of the return value.