# Working with HTTP
## checkConnection();
Check if there is an Internet connection available: if there is, then returns "true" (a String), otherwise "false".
## getWebContent(url,httpMethod,contentType,bodyRequest)
execute the HTTP request.\
Required parameters:
| Argument | Description |
| ----------- | -------------------------------------------------------------------------------- |
| url | URI to invoke (e.g. [http://host:port/webcontent](http://host/:port/webcontent)) |
| httpMethod | HTTP method to use; allowed values: GET, POST, PUT, DELETE |
| contentType | optional, can be null; e.g. application/json |
| bodyRequest | optional, can be null; the body request, expressed as a String |
```
The return value is a String content.
```
**Example**
```javascript
var url = getBaseURL()+"/executeJs?applicationId=...&appId=...&actionId=...&otherparameters&restfulToken="+getToken();
var json = getWebContent(url,"GET","application/json",null);
```
## getWebContent(url,httpMethod,contentType,bodyRequest,headers)
execute the HTTP request with headers.\
Required parameters:
| Argument | Description |
| ----------- | -------------------------------------------------------------------------------- |
| url | URI to invoke (e.g. [http://host:port/webcontent](http://host/:port/webcontent)) |
| httpMethod | HTTP method to use; allowed values: GET, POST, PUT, DELETE |
| contentType | optional, can be null; e.g. application/json |
| bodyRequest | optional, can be null; the body request, expressed as a String |
| headers | optional, can be null: the request headers, expressed as a map (a js object) |
```
The return value is a String content.
```
**Example**
```javascript
var url = getBaseURL()+"/executeJs?applicationId=...&appId=...&actionId=...&otherparameters&restfulToken="+getToken();
var headers = {
header1 : "ABCDEFG",
header2 : "12345",
};
var json = getWebContent(url,"GET","application/json",null,headers);
```
## getWebContent(url,httpMethod,contentType,bodyRequest,headers,callback)
execute the HTTP ASYNC request with headers and callback function.\
Required parameters:
| Argument | Description |
| ----------- | ---------------------------------------------------------------------------------------------------------- |
| url | URI to invoke (e.g. [http://host:port/webcontent](http://host/:port/webcontent)) |
| httpMethod | HTTP method to use; allowed values: GET, POST, PUT, DELETE |
| contentType | optional, can be null; e.g. application/json |
| bodyRequest | optional, can be null; the body request, expressed as a String |
| headers | optional, can be null: the request headers, expressed as a map (a js object) |
| callback | optional, can be null: the name of the callback async function, the input of function is the json response |
```
The return value is an empty String.
```
**Example**
```javascript
var url = getBaseURL()+"/executeJs?applicationId=...&appId=...&actionId=...&otherparameters&restfulToken="+getToken();
var headers = {
header1 : "ABCDEFG",
header2 : "12345",
};
function callbackAsync(response){
showMessageDialog({
title : "TITLE",
subtitle : "html response length: "+ response.length,
titleButtonSuccess : "ok"
},null);
}
var json = getWebContent(url,"GET","application/json",null,headers,"callbackAsync");
```
## getWebContentLite(url,httpMethod,contentType,bodyContent,headers, Object timeoutMS)
A lite version of getWebContent, this version not manages cookies, session and not refresh token. Use this function when you have to call a physical device like a WI-FI printer.
> Since 6.0.1 version
## getWebContentAdvanced(url,httpMethod,contentType,bodyContent,headers, timeoutMS)
Works like getWebContent, but the returns consists of:
* responseCode
* headers
* body
the getWebContent instead returns the body directly, or null in case of responseCode different from 200
> Since 6.0.2 version
## sendFile(url, filePath, fileName, jsCallback);
Invoke a remote serverto pass a local file using the POST HTTP method and the multi-part content type: a file and a filename will be passed.\
At the end of the sending process, the jsCallback will be invoked.\
Required arguments:
```
url - URL to invoke
filePath - absolute path (without the file name) in the local file system related to the file to send
fileName - file name to send; it is located in the absolute path specified through the previous argument
callback - function name which will be invoked when the file has been successfully sent;an argument is passed to the function, containing the response of the web service invoked
```
In the following example, a predefined Platform web service is invoked: it has been designed to work withHTTP requests having POST methodand multi-part content-type. Moreover, such a web service requires an action id which will be automatically invoked after sending the file. You can use it to process the file in some way and get back a response to the client.
```javascript
var myCallback = function(responseFromWebService) {
// do something with the response
}
var filePath = ...
var fileName = ....
var url = getBaseURL() + "/executeJs/uploadfile?appId=...&applicationId=...&actionId=...&dirId=...&unzip=false&restfulToken="+getToken();
sendFile(url, filePath, fileName, "myCallback");
```
## ping(ip, successCallback, errorCallback)
If the ip is available call the successCallback else the errorCallback.
> Since 6.0.2
## getConnectionData(callback)
Get the connection data and pass it to a callback. This function also save the connection data to server con60.
```javascript
getConnectionData("fun");
var fun = functioin(jsonData){
var data = JSON.parse(jsonData);
data.downloadRate //in KB/s
data.uploadRate //in KB/s
data.latency //in seconds
data.connectionType // WIFI - UNKNOWN - 2G - 3G - 4G - NO_CONNECTION
}
```
## logConnectionData()
Save the connection data on server con60, this function don't block the user interface.
## md5HexDigest(stringToEncode)
Return the string encode with md5
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://4wsplatform.gitbook.io/api-mobile/mobile-javascript-api/working-with-http.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.