SendGetRequest

Description

Sends the HTTP GET request to the server and then gets the content of the server response. It does not parse the HTTP response code and content of the server response.

It is NOT supported to use this method to process large data (20 MB or 100,000 data rows can be considered as large data based on our tests).

Applies to

RESTClient object

Syntax

objectname.SendGetRequest(string urlName, ref string response)

Argument

Description

objectname

The name of the RESTClient object from which you want to send the request.

urlName

A string value specifying the URL.

response

The content of the server response.

If RESTClient failed to send request or server provides no response, the response value is an empty string. If the response value is compressed, it will be automatically decompressed. Gzip and Brotli compression formats are supported. If the server specified the Content-Type response header, and in which the encoding charset is specified, this function will encode the data with the specified charset, if charset is not specified, this function will encode the data in UTF-8 by default.


Return value

Integer. Returns 1 if the function succeeds and a negative value if an error occurs. If any argument's value is null, the method returns null.

Example

The following example shows the usage of SendGetRequest.

RestClient lrc_P019
String ls_P019_ResPonse
lrc_P019 = Create RestClient

//Sets the request header to return a gzip package
lrc_P019.SetRequestHeaders("Content-Type:application/json;charset=UTF-8~r~nAccept-Encoding:gzip")
lrc_P019.SendGetRequest('https://demo.appeon.com/PB/webapi_client/api/department/retrieve', ls_P019_ResPonse)
If lrc_P019.GetResponseStatusCode() = 200 Then
 //Column name and type between dw_Data the returned JSON string ls_P019_ResPonse must match.
 dw_Data.ImportJson( ls_P019_ResPonse)
Else
 //Checks if any error according to the value of ResponseStatuscode and ls_Response
End If

See also

SendPostRequest

SendPutRequest

SendDeleteRequest

SendPatchRequest