httpGet

Function Server Only Online and Offline

Available since Server 1.0.0

void httpGet(string url, string postData, function dataReceivedCallback, function completedCallback)

The httpGet function is used to perform a HTTP transfer asynchronously.

If parameter postData is a blank string, then the GET request method is used, otherwise the POST request method is used.

Parameters

1)	string	url	The URL to send the HTTP request to.
2)	string	postData	The data to send as the body of the HTTP request.
3)	function	dataReceivedCallback	The scripting function to call when data is read from the connection. This can be called multiple times.
4)	function	completedCallback	The scripting function to call when data has been entirely read on the connection.

Return

void	This function doesn't return a value.

Callbacks

function dataReceivedCallback(ArrayBuffer/String receivedData)

This callback function can potentially be called multiple times for the same request.

1)

ArrayBuffer/String

receivedData

The data received, which could be all of the data or just 1 byte. ArrayBuffer is used in JavaScript, String is used in other scripting languages.

function completedCallback(int curlErrorCode, int httpResponseCode)

1)	int	curlErrorCode	The CURL error code. 0 means success. CURL Error Codes.
2)	int	httpResponseCode	The HTTP response code. HTTP Response Codes.

Notes

• You can use this function to convert a JavaScript ArrayBuffer to a JavaScript String:
  function ab2str(buf) { return String.fromCharCode.apply(null, new Uint8Array(buf));}
  .

Examples

There aren't any examples for this function.

Compatibility

• In server version 1.1.22 and before, there was an issue where the connection would close after the dataReceivedCallback callback was called first time and did not return the received data length.
• In server version 1.1.22 and before, there was also an issue where the POST request method was used if the postData parameter was a blank string.
• In previous server versions, for the JavaScript scripting language, the dataReceivedCallback callback was invoked with a string parameter instead of an ArrayBuffer parameter.

Related

Server Related

httpGet