v3.0 [Sep 26, 2011]
Awasu Server
Most of the work in this release has been updating the code base so that it can be shared between Awasu Server and the desktop version of Awasu. The functionality should remain the same, but some bugs may have been introduced by the code re-organization, so please keep an eye out for any odd or broken behaviour.
Please contact us if you are interested in running a server version of Awasu.
Awasu API
There are a slew of new functions:
$/stats Returns information about Awasu.
$/userInfo Returns information about the user account Awasu is running under.
$/logs/activity Returns the Awasu Activity log.
$/logs/error Returns the Awasu Error log.
$/channels/cleanup Returns channels that are eligible for cleanup.
$/channels/errors Returns the error log for channels.
$/channels/folders/tree Returns the channel folders in a hierarchial format.
$/channels/folders/create Creates a new channel folder.
$/channels/folders/delete Deletes a channel folder.
$/workpads/create Creates a new workpad.
$/workpads/update Updates the configuration for workpads.
$/workpads/delete Deletes workpads.
and other changes:
Upgraded the Python script for accessing the Awasu API.
Added a PHP script for accessing the Awasu API.
Completely reworked the HTTP engine for the Awasu API.
The Awasu API now supports compressed responses.
Awasu API arguments can now be specified in the HTTP POST data.
Include a <apiArgs> node as a top-level child, with each argument as an XML attribute.
Changed the way Awasu responds if channel/report/workpad API's are called but no objects are selected.
In particular, this means that $/channels/delete id=* no longer returns an error if there are no channels.
The Awasu API now recognizes @ to mean the default workpad when creating reports and channels.
Split the $/workpads/list functionality into $/workpads/list and $/workpads/get (these now work in the same way as the corresponding channel and report functions).
$/workpads/list now returns information about custom fields.
The channel GUID is now included in the output for API calls $/channels/stats and $/channels/list.
$/channels/list now returns the path to a channel hook's .HOOK file (not its script).
Custom fields are now included in the response for $/workpads/feed.
$/buildInfo now returns the build options (add a "verbose=1" parameter).
Tweaked the way $/buildInfo returns the expiry date (for expiring builds of Awasu).
$/stats now returns the number of channels currently updating.
$/channels/list now returns the number of new and unread items.
$/channels/list now returns the number of update errors.
$/channels/list now returns the channel GUID's.
$/channels/create now expects search channel score cutoffs to be between 0 and 1.
Changed the way a channel's auto-update enabled flag and interval are passed in and out of the Awasu API.
$/reports/list now includes the flag that controls whether the report post-processing command is visible or not.
{%BUILD-DATE%} and {%EXPIRY-DATE%} now respond to the standard timeZone=... and format=... parameters.
Awasu API request parameters are now decoded correctly.
Fixed the handling of special characters in search queries that come in via the Awasu API.
Stopped Awasu API responses from being converted to UTF-8 twice.
Awasu no longer responds to API requests when it is shutting down.
Awasu no longer exposes passwords in logs or API calls.
Awasu now uses a special token (generated each time it starts) in the cases where the token must be embedded in HTML (e.g. the search page).
The Awasu API token is now encrypted in CONFIG.INI.
You will need to re-enter your API token in the Program Options dialog.
The outputFile= Awasu API parameter is now only recognized for requests submitted via the awasu:// protocol.
The Awasu API now falls back to XML format when returning an error for an unknown API request.
Added a muppet header to the $/stats and $/reports/list XML response files.
Added a new {%IS-SERVICE%} parameter to the $/buildInfo templates.
The JSON response for $/channels/cleanup now has a root node.
The JSON response for $/search/query and $/feedItems/get now return the text type for each text field.
Fixed a problem with how Unicode text was being returned in JSON responses.
Fixed errors in some JSON template files.
Added HTML templates for many API requests.
HTML template files are now marked as UTF-8.
The HTML template for $/workpads/list now links to each individual workpad.
The Awasu API now supports requests for a favicon.
The Awasu API no longer returns channels that are in the process of being deleted.
Tweaked some Awasu API error messages.