How requests are sent to Awasu

Awasu passes a string to plugins via the AppPluginServerUrl parameter in the INI file that might look like this:

[System]
AppPluginServerUrl = http://127.0.0.1:12345

Plugins can then use this value to generate and insert URL's into a page that would then look like this:

http://127.0.0.1:12345/MyAppPluginId/foo/bar?p1=hello?p2=world

Awasu will be listening on the appropriate port and receives the HTTP request when the user clicks on the link. It figures out which plugin to send the request to (using the plugin ID embedded in the URL) and inserts the request name and parameters into the plugin's INI file, like this:

[System]
Command = ProcessRequest
PluginRequest = foo/bar
ParamString = p1=Hello&p2=World

The plugin can then use this information to process the request appropriately.

 

Warning
You should not rely on the port number being any particular value since the user can change it in the Program Options.

You should also not rely on the format of the AppPluginServerUrl parameter since it may change in future versions of Awasu.