REST.patch

From RPTools Wiki
Revision as of 04:16, 16 March 2019 by Phergus (talk | contribs) (Created page with "{{MacroFunction |name=REST.patch |trusted=true |version=1.5 |description= Perform an HTTP patch request, to the specified URL, to make a partial update to the specified resour...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

REST.patch() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.5
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 -
  • payload -
  • mediaType -
  • headers -
  • getFullResponse - Boolean (0: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

TEXT HERE
[h: baseURL = "https://reqres.in"]
[h: path = "/api/users/2"]
[h: mediaType = "application/json; charset=utf-8"]
[h: getFullResponse = 0]

[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:

TEXT HERE

See Also

Version Changes

  • 1.5 - Added to main MapTool build.