HTTP Request Methods
| Method | Action | Description |
|---|---|---|
| GET | Read Requests | The method requests a representation of a specified resource. The representation can be either a single resource or a collection. |
| PATCH | Update | The method applies partial modifications to a resource. |
| PUT | Replace | The method completely replaces a resource. Any properties omitted from the body of the request are reset to their default value. |
| POST | Create | The method creates a new resource. This request is submitted to the resource collection in which the new resource is meant to belong. |
| POST | Actions | The method initiates operations on the object (Actions). The POST operation may not be idempotent. |
| DELETE | Delete | The method removes a resource. |
Responses
There are four types of responses:
| Response | Description |
|---|---|
| Metadata | Resources and types are exposed by the service to generic clients. |
| Resource Responses | An individual resource is displayed in JSON format. |
| Resource Collection | JSON representation of a collection of resources. |
| Error | Top-level JSON response providing additional information in the case of an HTTP error. |
HTTP Status Code Description
| Status Code | Description |
|---|---|
| 200 | OK |
| 201 | Created |
| 202 | Accepted |
| 204 | No Content |
| 301 | Moved Permanently |
| 302 | Found |
| 304 | Not Modified |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 405 | Method Not Allowed |
| 406 | Not Acceptable |
| 409 | Conflict |
| 410 | Gone |
| 411 | Length Required |
| 412 | Precondition Failed |
| 415 | Unsupported Media Type |
| 500 | Internal Server Error |
| 501 | Not Implemented |
| 503 | Service Unavailable |