The VisualCron Web API is an alternate way to interact with VisualCron and extract information. The settings for controlling ports and enabling the Web API is located in the in the Server settings->Server tab:
Allow Web API
When checked VisualCron open ports for Web API.
The Web API uses two ports for communication. The encrypted one uses a certificate created by VisualCron to enable a secure communication channel.
The Web API uses the same permission system as in VisualCron which means that you need to add a user in Manage user permissions window first.
Once the WebAPI is allowed you can see available methods here:
Calling the Web API
There are two ways of requesting information:
The VisualCron REST service communicate through the HTTP protocol. By making simple HTTP calls against the VisualCron service you can easily extract information and interact with VisualCron. The REST service is able to return 3 different result outputs:
Text - plain text output
XML - XML output
JSON - JSON output
The output method is controlled through the url:
By default, if you use text as output headers are added (property names). If you want to exclude these you can set &includeheaders=false in the query. By default available properties will be listed but you can also set which properties (columns) to include like this:
It is possible to control the field separator, text qualifier and line break like this:
Tokens and authentication
It is possible to authenticate once and use a token that will work for 24 hours (and will be renewed for each call). The token is then used in each call. You can also authenticate each time you call a method. Using token and a method requires at least 2 calls instead of supplying user name and password in each call. However, using tokens is faster in the long run and generally more secure.
To get a token you authenticate against the the logon method:
This call returns a token that you can used in following calls like:
Authenticate in call
By adding username and password parameters you can work directly with the method without using tokens.
2. Web service/SOAP
It is also possible to communicate with VisualCron through the web service API. The wsdl URL can be found in the Web API tab in Server settings.
There is the following example in the API folder (sample TestClient project):
var binding = new BasicHttpBinding()
MaxBufferPoolSize = int.MaxValue,
MaxReceivedMessageSize = int.MaxValue,
MaxArrayLength = int.MaxValue,
MaxStringContentLength = int.MaxValue,
MaxNameTableCharCount = int.MaxValue
Security = new BasicHttpSecurity()
Mode = BasicHttpSecurityMode.TransportCredentialOnly,
Transport = new HttpTransportSecurity()
ClientCredentialType = HttpClientCredentialType.Basic
var client = new WebServiceClient(binding, new EndpointAddress("http://localhost:8001/VisualCron"));
//var client = new WebServiceClient();
//but better setup binding
if (client.ChannelFactory.Credentials != null)
client.ChannelFactory.Credentials.UserName.UserName = txtUserName.Text;
client.ChannelFactory.Credentials.UserName.Password = txtPassWord.Text;
//just call methods
var jobs = client.Job_List();
foreach (var job in jobs)