Home > Developer > Lookafter Storage System API > Changes Log
Updated documentation for GetItemInfo and SetItemInfo API in response to new changes. In the returned ucar info, GetItemInfo will now NOT show user groups that the user do not belong to. GetItemInfo previously return a ucar set that includes all groups in the user's host/domain and SetItemInfo similarly also requires the same whole set to be submitted back to effect a change. Now SetItemInfo is aware of the new changes in GetItemInfo and it also allow part ucar set to be submitted to just change that part of ucar settings only.
Updated documentation for Zipped Download to list the current limitations. The API now ignores user's file creation and file writing privileges for the temporary creation of a ZIP file. Previously this check prevented users who are not given file creation / writing permission to be blocked.
Extended DropBox Listing API to return pickup_url and passphrase. This is to match what is returned by DropTo API.
Extended DropTo API to take two new parameters, namely, do_not_notify and passphrase. do_not_notify will disable the sending of email to the recipient, and passphrase will accept an optional phrase that will be requested from the recipient for matching before access to the drop item will be granted. Updated documentation accordingly.
Extended Search API to also generate optional JSON output. Updated documentation accordingly.
Changes to returned value from GetDir and GetItemInfo.
Previously the size returned for a folder item is always zero, which is not useful. Now the size returned for a folder item is the total size of all files and subfolders within that folder. The total size includes small amounts of hidden system resources which is also included in the total storage space used up. So, the value will be a positive integer (possible but unlikely to be zero) indicating the storage space occupied by the folder content. This value is suitable to be shown in directory listings next to folder names, just like file sizes are shown next to file names. HOWEVER, while rarely, please note that this value can be -1 or “blank” if the folder has never been sized up by the backend sytem yet. When this happens show a blank or indicate that folder size is not available at the moment.
Added new API zip_download.cgi (Zipped Download) for downloading a set of files or folder as a zipped file.
Added new option to get_file.cgi (Get File) to suppress the first line “true NNN” in the returned file content in successful cases.
Extended all published APIs (except search.cgi) to generate optional JSON output for those that did not do so before.
Also extended them to return appropriate HTTP status code to reflect the success or failure of the call.
Editing the published documentation to reflect these changes.
New APIs introduced to list and manage the shared folder (share_list.cgi and share_manage.cgi).
Bug fix to DiskUsage API so that it will return gracefully for certain exceptional input cases.
Its documentation is also updated for greater clarity.
Bug fix to AntiVirus Scan API where incorrect path to infected file was returned.
Extended AntiVirus Scan API to produce equivalent output in JSON format.
Added two new APIs for Encrypt and Decrypt.
Two new APIs introduced, DropItem Accept and DropItem Reject, to facilitate the acceptance and rejection of dropfiles.
Document the AntiVirus Scan API, which was created much earlier but was not published then.
DroptTo (dropto.cgi)
Extended to accept new input parameters item_list_json and email_list_json to complement item_list and email_list.
As the name imply, item_list_json and email_list_json accepts list input in the form of a JSON object.
Dropbox Listing (dbox_list.cgi)
Bugfix for the case of requesting for from_user list and database handle getting disconnected prematurely.
Also revise documentation for this API to include sortby and sorthow parameters, additional examples, and improve clarity.
GetDir's documentation added for fields=lock_owner. This was left out earlier.
GetItemInfo extended return UCAR settings of item (where available) in the form of a JSON object. Also extended to return entire API response as a JSON object.
Added input parameter “ofmt” to control the API response format, JSON or legacy format.
Added documentation on the input parameter “lock_owner” which was left out previously.
Corrected the returned value of “lock” to match legacy expectations.
SetItemInfo extended to accept new UCAR settings of item (where applicable) thus allowing the changing of a set of UCAR setting of the item.
Delete can now delete multiple items in one call. The multiple items to delete are specified in multiple “path” input parameters.
PutFile now returns the autorenamed name in the case when it happens.
DiskUsage & DiskQuota documentation has be revised for better clarity.
GetDir inherited the changes for GetItemInfo and therefore, lock and lock_owner properties works as in GetItemInfo.
(The returned ucar property will be extended later to be the same as in GetItemInfo when the API output support JSON. Stay tuned.)
Updated documentation for PutFile with respect to autorename
Modified API tn.cgi. Allowed to cache into different set of thumbnails using the new -s option.
The -c option is redefined and extended.
Some optimization with hope for improved performance.
Added a new API tn.cgi, specifically for thumbnail generation.
Added a new parameter “cl” for the get_file.cgi API.
Added new API Image Convert.
Bug fix to DropTo. The returned “error_items” parameter was incorrectly formed.
Input parameter “language” possible values changed for ease of understanding.
UTF8 encoding is expected for input parameters and output parameters where they can possible occur, e.g. filenames, msg_subject, addmsg in Chinese.
Added new API Dropbox Listing. This API returns the list of items dropped to the authenticated user.
It can also list the items dropped by the authenticated user.
Added new APIs Recent Emails and DropTo. Also first time trying out returning JSON formatted output.
Amended documentation for API DiskUsage & DiskQuota because the API functionally had to be change for backward compatibility reasons.
Added documentation for API DiskUsage & DiskQuota
Amend the script path to be relative to /storage/bin/api
Max filename should be 255 characters.
Extended SetItemInfo and GetItemInfo to support getting and setting date, dategmt, mtime.
Extended GetDir to work for root paths and toplevel folder paths.
Updated the API descriptions.
Added new API, Search (search.cgi) to find for files or folders whose name matches a certain pattern or whose description matches a certain pattern.
Extended PutFile (put_file.cgi) to handle the data parameter to be submitted as in “file upload” style.
This means the data is in a multipart/form-data section and POSTed to put_file.cgi. The section is similar to that generated by a client (browser) submitting a <INPUT TYPE=“file”> field. (See the PutFile API description for details.)
Added new API, DropItemCount (drop_item_count.cgi) to get the number of drop items and number of newly dropped items in a user's dropbox.
Extended “fields” parameter of GetItemInfo (get_item_info) to accept “checksum”, which cause it to return the MD5 checksum of the item, if it is a file. If the item is NOT a file, the API will just return null value in place of where a file checksum will appear without aborting the call. This is in contrast with GetChecksum (get_checksum.cgi) that will abort if the item is not a file. The “fields” parameter for GetDir (get_dir.cgi) is similarly extended.
Extended “filter” parameter of GetDir (get_dir) to accept multiple patterns to filter filename listing. e.g. *.jpeg,*.jpg
First beta release.