HTTP Response Codes
The request to the server can return a successful status or an error.
Success Operation Statuses
|
Code |
Applies to HTTP Method |
Description |
Response Body Content |
Details |
|---|---|---|---|---|
|
200 |
GET PUT |
OK |
Resource representation |
The operation has been successfully completed. |
|
201 |
POST |
Created |
Representation of the created resource |
The resource has been successfully created. |
|
202 |
POST DELETE |
Accepted |
n/a |
The request has been accepted and a task to handle the request has been created. A 202 response is typically used for actions that take a long while to process or performed asynchronously. This response is accompanied by a task resource. |
|
204 |
PUT POST DELETE |
No Content |
n/a |
The request is valid and has been successfully completed; the response does not include a body. A 204 status can be sent, for example, as a response to the DELETE HTTP request, informing that a resource has been deleted and has no representation. |
Error operation statuses
|
Code |
Applies to HTTP Method |
Description |
Response Body Content |
Details |
|---|---|---|---|---|
|
400 |
POST PUT |
Bad Request |
Error |
The request body is malformed, incomplete or otherwise invalid. |
|
401 |
All |
Unauthorized |
Error |
The authorization header has been expected but not found (or found but is expired). |
|
403 |
All |
Forbidden |
Error |
The user sending a request does not have adequate privileges to access one or more objects specified in the request. |
|
404 |
All |
Not Found |
Error |
One or more resources specified in the request could not be found in the specified resource collection. |
|
405 |
All |
Method is not Allowed |
Error |
The HTTP method specified in the request is not supported for this resource. |
|
500 |
GET POST PUT |
Internal Server Error |
Error |
The request has been received but could not be completed because of an internal error at the server side. |
|
501 |
POST PUT DELETE |
Not Implemented |
Error |
The server does not support the functionality required to fulfill the request. |
|
503 |
All |
Service Unavailable |
Error |
The server is currently unable to handle the request due to a temporary overloading or maintenance of the server. |