⁉️Timeouts and Errors

Description of error and timeout handling in the Labelcamp API

Despite our best efforts, the API can sometimes experience temporary slowdowns or raise unexpected exceptions.

Timeouts

Database Timeout

Database operations are limited to 90 seconds. After this delay, the API will return a 504 http status code (Gateway Timeout) and a "DB query cancelled" message. If this happens, the call can be retried since the database operation has been cancelled.

You can try to trigger such a timeout to manage it properly in your application on the following route.

Triggers a DB timeout on the API

GET https://api.idol.io/api/v2/timeouts/trigger

Path Parameters

Name
Type
Description

kind*

String

db

App timeout

Operations on the API are limited to 120 seconds. This includes any database operations described above, which are limited to 90 seconds. If a call exceeds 120 seconds, the API returns a 504 (gateway timeout) http status code and a "Request Timeout" message.

You can try to trigger such a timeout to manage it properly in your application on the following route.

Triggers an app timeout on the API

GET https://api.idol.io/api/v2/timeouts/trigger

Path Parameters

Name
Type
Description

kind*

String

http

Errors

It may happen that an API call raises an unhandled exception in the application. In this case, the application returns an http 5XX status code depending on the type of error, and a message.

In such cases, we are notified of such exceptions in our monitoring tools, but it's important to also inform us by contacting our support at [email protected], being as precise as possible about the context of the error (time of request, URL, arguments passed during the call, server response).

You can try to trigger such an error to manage it properly in your application on the following route.

Triggers an error on the API

GET https://api.idol.io/api/v2/timeouts/trigger

Path Parameters

Name
Type
Description

kind*

String

error

Last updated