Web services - errors

When an error occurs as a result of a call to the web services, the response will be a JSON or XML formatted documented (depending on the format of your call) containing the error message and an error code:

<?xml  version="1.0" encoding="UTF-8"?>
<error>
  <message>...</message>
  <code>...</code>
</error>

or alternatively as JSON:

{
  "error": "...",
  "code": "..."
}

For the JSON response format, an unexpected error will also contain the file the error occurred in, line number and a trace of the error stack:

{
  "error": "...",
  "code": "...",
  "file": "...",
  "line": "...",
  "trace": []
}

When a validation error occurs, the JSON contains a single summary error message as well as individual messages with keys indicating the fields that the errors occurred against:

{
  "error": "Validation error",
  "code": "2003",
  "errors" {
    "sample:date":"The date is required",
    "sample:entered_sref":"The spatial reference is required"
  }
}

Note that if the application/config/indicia.php file contains a setting http_status_responses=true; then HTTP status codes will be set on the response. This is not enforced for backwards compatibility reasons.

Error codes

The following table lists the error codes that can be returned:

Code	Description
0	Unspecified error
1	Authentication failure - tokens expired or incorrect
1001	Read failure - record not found or website ID of requested data does not match request
1002	Read failure - requested a custom view which does not exist for this entity
1003	Read failure - requested a standard view which does not exist for this entity
1004	Read failure - requested an entity not restricted to a website but without full access
2001	Write authorisation failure - website ID of written data does not match request
2002	Write failure - entity not writeable
2003	Validation failure on a submission
2004	Validation failure on an import
3001	Internal error in secure message system - should not occur
4001	Incorrect spatial reference format in spatial services request