Guides

Error Handling and Messages

UXCam server issues a status code for every request made by its clients. The status of the response can be decoded using the table below.

Status CodeReasonDescription
200OKThe HTTP 200 OK success status response code indicates that the request has succeeded
400Bad requestsThis response status code indicates that the server cannot or will not process the request due to a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing)
401Unauthorised requestsThis response status code indicates that the client request lacks valid authentication credentials for the resource.

Missing valid API Key or App ID key
403Forbidden requestsThis response status code indicates that the server understands the request but refuses to authorise it
404Resource Not FoundThe requested resource doesn't exist in the server
429Request limit exceededThis response status code indicates the user has sent too many requests in a given amount of time
500, 502, 503, 504Internal Server ErrorThese are server error response codes that indicate the server encountered an unexpected condition that prevented it from fulfilling the requests

Rate Limiting

[status code: 429]:

This means you've made frequent calls to an API that exceeded the call rate limit. UXCam has implemented the following rate limit.

  • A maximum of five concurrent requests per second
  • A maximum of 500 requests per hour
  • A Total number of 500 records can be fetched on a single request.

If any of the above-mentioned conditions are met regarding the rate limit, then APIs will start to throw a 429 status code. This limit will only be reset every 24 hours.

📘

Note

To minimise rate-limiting errors, consider combining multiple filters, groupings, and aggregations into a single request to make multiple queries.