HTTP status codes
200 OK
The request has been accepted and processed. The response contains a JSON object.
400 Bad Request
The server cannot process the request due to something that is perceived to be a client error, for example malformed request syntax.
It can happen when the JSON object posted with the request is invalid.
For example, the following is not a valid JSON object because both the external curly braces and the quotation marks around the properties names are missing.
document: {
text: "Michael Jordan was one of the best basketball players of all time. Scoring was Jordan's stand-out skill, but he still holds a defensive NBA record, with eight steals in a half."
}
401 Unauthorized
The reasons for this state can be:
- invalid credentials were specified when requesting the authorization token
- the authorization token is missing
- the authorization token is not valid
- the authorization token has expired
403 Forbidden
This code is returned when requesting resources that are outside the scope of the plan that the user subscribed or when one or more of the plan limits—for example the characters per month limit—have been reached.
404 Not Found
The server can not find the requested resource, the URL is wrong.
413 Request Entity Too Large
The request is larger than the limit defined by the plan the user subscribed.
500 Internal Server Error
The server has encountered a situation it doesn't know how to handle.