The CDD API attempts to return appropriate HTTP status codes for every request.
Common status codes include:
- 200 OK: request processed successfully.
- 400 Bad Request: Can be malformed JSON syntax or a database conflict (e.g. trying to create a molecule that already exists).
- 401 Not Authorized: either you need to provide authentication credentials, or the credentials provided aren't valid.
- 403 Forbidden: CDD understands your request, but refuses to fulfill it. An accompanying error message should explain why.
- 404 Not Found: either you're requesting an invalid URI or the resource in question doesn't exist (e.g. no such molecule).
- 500 Internal Server Error: Something went wrong... Please contact support.
- 503 No server error: usually occurs when there are too many requests coming into CDD.
The body of an error response may contain a JSON structure with more information about the nature of the error, e.g.
{"error":"Mapping not valid"}