Resource Methods
You can execute the standard methods to interact with either a singular resource or a resource collection, using their URLs.
Get
Use this method to query and retrieve information. Parameters in a GET method are common for both singular resource and resource collection. However, the parameters used in the query to refine the search or filter the results in a singular resource are different from those used in a resource collection.
The following parameters are used in a GET method for querying a collection resource, in addition to the common parameters.
Parameter | Parameter |
---|---|
limit |
A positive integer value that specifies the maximum number of items that a server returns. The server might override the value to improve performance. If the client doesn't specify a limit value, then the server uses a default limit value. |
offset |
A positive integer value that specifies the index of the first item to be returned. The offset index begins at 0. For example, to return items in a collection, use:
Note: Specify values for both the limit and offset query parameters to obtain a paginated response.For example, if there are 100 opportunities and a client sends the request GET /opportunities?offset=10 &limit=20, then the response contains opportunities from 11 to 30. Note:
|
Post
Use this method to create a new item. The request media type is as follows:
application/json
Patch
Use this method for making partial updates to a resource. Only the fields contained in the request body are updated. The request media type is as follows:
application/json
Put
Use this method for making partial updates to a resource. The request media type is as follows:
application/json
Delete
Use this method to delete a resource. It doesn't require a request body.