HTTP status codes & Error messages

How to interpret error information

HTTP status codes

For each request, the Lingohub API tries to return suitable HTTP status codes. Response codes for the REST API can be suppressed. Below is a list of status codes that are used:


CodeNameMeaning
200OKSuccess!
304Not ModifiedNo new data was found.
400Bad RequestYour request was not valid. There will be an explanatory error message.
403UnauthorizedThere are missing or incorrect authentication credentials.
403ForbiddenYour request was understood but has been refused due to missing rights. An explanatory error message will appear.
404Not FoundThe URI requested is invalid, or the requested resource, a project, for example, does not exist.
406Not AcceptableThe API will return this code if an invalid format is specified in the request.
429Too Many RequestsIf too many requests are performed quickly, the API rate limit is exceeded, and this code will be returned.
500Internal Server ErrorPlease inform the Lingohub Support team, which will investigate the issue as something is damaged.

Error messages

When the Lingohub API returns error messages, it does so in your requested format.
For example, an error from a JSON method might look like this:


{  
  "error": "The 'page_size' parameter must be between 1 and 100 but was -1"  
}