Response Codes
What are the various response codes that I can use?
Errors are signaled using HTTP status codes. The standard status codes are used as defined in RFC 2616. The corresponding error messages are delivered in JSON format and specified in LINK TO BE INSERTED.
| Response Code | Status | Description |
|---|---|---|
| 2xx | Success | |
| 200 | OK | Successful request, response object returned |
| 202 | accepted | The request was received but not yet fully processed (for example, batch). |
| 204 | No response | Request successful, but there is no information to send back |
| 4xx | Client error | |
| 400 | Bad request | The request could not be understood due to malformed syntax. Explanatory error messages are delivered in the following generic format: { "description": required, error message "what": required, reference to errored object } |
| 401 | Unauthorized | The request was sent without valid client authentication credentials for the requested action. |
| 403 | Forbidden | The request is not supported at the given URL or your client IP address is blocked. |
| 404 | Not found | The requested resource was not found. This can apply to one or multiple resources required, details are given in the error message. Explanatory error messages are delivered in the following generic format: { "description": required, error message "what": required, reference to errored object } |
| 409 | Conflict | The request cannot be fulfilled because it conflicts with the current state of the system. For example, a certain resource already exists and cannot be created twice. Explanatory error messages are delivered in the following generic format: { "description": required, error message "what": required, reference to errored object } |
| 415 | Unsupported media type | A media type other than application/json or no media type has been specified. |
| 429 | Too many requests | |
| 5xx | server error | |
| 500 | Internal server error | The server encountered an unexpected condition which prevented it from fulfilling the request. |
| 503 | Service unavailable | The server is currently unable to handle the request due to a temporary overloading or maintenance of the server. |