REST.patch: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page REST.patch to rEST.patch: Converting page titles to lowercase) |
m (Taustin moved page rEST.patch to REST.patch without leaving a redirect) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 7: | Line 7: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
REST.patch(url, payload, mediaType, getFullResponse) | REST.patch(url, payload, mediaType, getFullResponse) | ||
REST.patch(url, payload, mediaType, headers, getFullResponse) | REST.patch(url, payload, mediaType, headers, getFullResponse) | ||
</ | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
| Line 24: | Line 24: | ||
|example= | |example= | ||
Update user data with contents of payload. | Update user data with contents of payload. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: baseURL = "https://reqres.in"] | [h: baseURL = "https://reqres.in"] | ||
[h: path = "/api/users/2"] | [h: path = "/api/users/2"] | ||
| Line 37: | Line 37: | ||
<pre> | <pre> | ||
[r: json.indent(response, 2)] | [r: json.indent(response, 2)] | ||
</pre></ | </pre></syntaxhighlight> | ||
Returns: | Returns: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
{ | { | ||
"status": 200, | "status": 200, | ||
| Line 58: | Line 58: | ||
"updatedAt": "2019-03-17T22:46:47.729Z" | "updatedAt": "2019-03-17T22:46:47.729Z" | ||
} | } | ||
}</ | }</syntaxhighlight> | ||
|also= | |also= | ||
Latest revision as of 16:24, 10 May 2023
REST.patch() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.5.0
Perform an HTTP patch request, to the specified URL, to make a partial update to the specified resource.
Usage
REST.patch(url, payload, mediaType, getFullResponse)
REST.patch(url, payload, mediaType, headers, getFullResponse)Parameters
url- String containing the URL to the resource or collection of resources.payload- JSON object containing the key:value pairs.mediaType- String containing a MIME type and charset. See example.headers- JSON object containing header key:value pairs.getFullResponse- Boolean (0:1). Use true(1) to get full response.
Returns
HTTP response as JSON (if full response) or server response, usually JSON but can be XML, HTML, or other formats.
Example
Update user data with contents of payload.
[h: baseURL = "https://reqres.in"]
[h: path = "/api/users/2"]
[h: mediaType = "application/json; charset=utf-8"]
[h: getFullResponse = 1]
[h: payload = '{ "name": "morpheus", "job": "zion resident" }']
[h: response = REST.patch(baseURL + path, payload, mediaType, getFullResponse)]
<br>
<pre>
[r: json.indent(response, 2)]
</pre>Returns:
{
"status": 200,
"headers": {
"access-control-allow-origin": ["*"],
"cf-ray": ["4b927aa4ea915414-LAX"],
"content-type": ["application/json; charset=utf-8"],
"date": ["Sun, 17 Mar 2019 22:42:16 GMT"],
"etag": ["W/\"50-xvMYBAeY4FNOMM/22NyIcimiIYc\""],
"expect-ct": ["max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""],
"server": ["cloudflare"],
"set-cookie": ["__cfduid=d97966d3e9434720192d81096687475ff1552862536; expires=Mon, 16-Mar-20 22:42:16 GMT; path=/; domain=.reqres.in; HttpOnly"],
"x-powered-by": ["Express"]
},
"body": {
"name": "morpheus",
"job": "zion resident",
"updatedAt": "2019-03-17T22:46:47.729Z"
}
}