The following tables explains the mapping of HTTP and API methods.
HTTP Method |
API Method |
Rule Description |
---|---|---|
GET |
Read |
Read data based on provided parameters, does not change existing objects |
POST |
CreateOrUpdate |
Update existing objects or create those that are not found |
PUT |
Create |
Create new objects always, do not change existing objects |
DELETE |
Delete |
Delete objects based on provided identifier(s) |
PATCH * |
Update |
Update existing matching objects only * This mode must be specified as "_method=PATCH" URL parameter, see below. |
The HTTP method will be taken from the HTTP request itself. Alternatively, for write requests, you can override the HTTP method by specifying a URL parameter "_method", with valid values of "POST", "PUT", "PATCH", or "DELETE".
The "_method" parameter is not supported for "GET" HTTP requests, which are always only reads.
For example, to invoke an update-only write operation, add this URL parameter and submit the data through a POST method:
http://.../?_method=PATCH
API runtime parameters, if any are defined for the given API, are passed in using the defined syntax (Rest Parameters and Options).