HTTP Response Codes and Errors

The REST API methods attempt to return appropriate HTTP status codes for every request. To use the REST API effectively, a good understanding of HTTP and status codes is required. A complete list of HTTP status codes and definitions can be found at the following website: HTTP/1.1 Status Code Definitions

The primary status codes used by the REST API are as follows:

•

200 OK—Success.

•

201 Created—A resource was successfully created.

•

400 Bad Request—Invalid data was supplied for the relevant resource type.

•

401 Unauthorized—The requested resource cannot be loaded until valid sign-in credentials have been entered. If this error is received after credentials have been entered, it indicates that the credentials are not valid.

•

403 Forbidden—Access to the requested resource has been denied. (Make sure that the authorized user has administrative privileges.)

•

404 Not Found—The URI requested is invalid or the resource requested does not exist.

•

413 Request Entity Too Large—The request is larger than the server is able to process.

•

500 Internal Server Error—A generic error message, given when there is no suitable specific message.