Error handling

For ACTIVE Net Insights Data API requests, a response contains the following two types:

HTTP status codes

ACTIVE Net Insights Data APIs use the following standard HTTP status codes:

Code Name Description
200 OK The request is successful.
400 Bad Request The server cannot process the request due to a client error (e.g. an invalid data type for a query parameter)
403 Forbidden The server understood the request but refused to authorize it.
(e.g. a missing, invalid, or expired API key)

504

Gateway Timeout

The serve which is acting as a gateway or proxy did not receive a timely response from the upstream server specified by the URL.
(e.g. Timeout or API is not available)
596

Service Not Found

A request to an invalid service or endpoint

For more information about HTTP status codes, refer to https://tools.ietf.org/html/rfc2616#section-10.4.

Error Messages

ACTIVE Net Insights APIs may respond with ACTIVE Net Insights defined error messages.

 

If an error has occurred, then the response body contains information about the error.

 

Example: if the request contained an invalid request parameter, then the following response body is returned:

 

{

    "errorMsg": "Unknown parameters: [test123]"

}

 

Related topics

Getting Started Guide

Authentication

Retrieving data from ACTIVE Net Insights

Common parameters

Terms of Use