updated API to support API authentication and added comments to all major interfaces to improve documentation