The Dialectic remote HTTP server allows web-enabled devices to contact Dialectic and initiate a call, trigger an incoming call action, add a Call Log entry, or retrieve the Call Log or Quick Dial number list.
To enable the internal HTTP server, you must provide a password and a port number. The password cannot include spaces and must be included as a parameter in any request sent to the server. The port number is the port that Dialectic will listen to in order to respond to HTTP requests.
The Dialectic HTTP Server responds to 6 actions:
All of the actions except challenge require passing at least the password parameter as defined in the Dialectic Remote section of the preferences. You can send Dialectic these commands either from a URL or from a form. To use the server, you must know the IP address of your machine, the password, and the port number. For instance, to get the Call Log as an HTML file, with the HTTP server running on a machine with an IP address of 192.168.0.100, the port set to 58384, and a password of SECRET, you could use the URL:
http://192.168.0.100:58384/getCallLog?password=SECRET
For added security, you can send an MD5 hash of a nonce and the password instead of the password itself. To use this feature, instead of including the password parameter, include:
nonce=NONCE_VALUE&hash=HASH_VALUE
where NONCE_VALUE is retrieved from the Dialectic HTTP server itself using the challenge command and HASH_VALUE is an MD5 hash of:
NONCE_VALUE:password
So, for example, query the Dialectic server for a nonce value with the challenge command:
http://192.168.0.100:58384/challenge
The Dialectic Remote HTTP server will respond with a reply such as e2f1d466511d53efd3c3e015d5d18378. Using this as your NONCE_VALUE and assuming your password is SECRET then the HASH_VALUE would be an MD5 hash of e2f1d466511d53efd3c3e015d5d18378:SECRET (6e13e1fd07a41e8a814796b4e56cc713) so the parameters would be:
nonce=e2f1d466511d53efd3c3e015d5d18378&hash=6e13e1fd07a41e8a814796b4e56cc713
Using this alternate nonce & hash method, the URL to retrieve the call log would then be:
To easily see the URLs and parameters required for all of the supported commands, click the “Test Dialectic Remote HTTP Server” button in the Dialectic Remote section of the preferences. Of course, if you want to make this server accessible to outside resources, you’ll need to configure your firewall, router, or other network devices accordingly.
The following pages demonstrate sending commands to Dialectic as URLs but, again, you could also send any of this information from a web form. See the HTTP server test page for more information.
