SendCustomRequest Method
Sends a custom request to the ShareFile API.
Syntax
async sharefile.sendCustomRequest(httpMethod : string, requestPath : string, requestBody : string): Promise<void>
Remarks
This method can be used to send arbitrary requests to the ShareFile API.
Valid values for HttpMethod are:
- GET (default if empty)
- HEAD
- POST
- PUT
- PATCH
- DELETE
Usage
When this method is called, the class does the following:- Builds a request URL, including query parameters, as follows:
- The specified RequestPath is appended to the ShareFile API's stable endpoint, https://[SUBDOMAIN].sf-api.com/sf/v3.
- All query parameters in the QueryParam* properties are added to the request URL.
- Sends the request using the specified HttpMethod, the request URL build in step 1, the header information held by Authorization and OtherHeaders, and the given RequestBody (if non-empty).
- Stores the response headers in the ParsedHeader* properties, and the response body in the specified LocalFile (using the same logic as DownloadFile).
If the response body is JSON data, the XPath, XText, and other X* configuration settings can then be used to navigate and extract information from it.