We would like to bring it to your notice that we have introduced few mandatory changes in Zoho Reports API usage, for better usability and other technical considerations. This would require some minor, but mandatory, changes to be done in your existing applications. 

 

Introducing support for Permanent Authentication Token for API calls 

Zoho Reports now supports passing a permanent Authentication Token (AuthToken) to use Zoho Reports API methods. Using AuthToken is much simpler than the current tedious process of frequently generating temporary ticket to authenticate user credentials for using the API.  

The AuthToken is a permanent user specific authentication token that needs to be passed along with every Zoho Reports API call. This token is specific to each Zoho service and cannot be interchanged among Zoho services (i.e., the AuthToken generated for Zoho CRM API cannot be used with Zoho Reports API). Generating the AuthToken is a straight forward, one-time process. The token will remain valid till it is explicitly removed or regenerated. 

Click here for more details on this change. 

 

Ticket based Authentication to be Removed after July 30th 2013

On account of the AuthToken support mentioned above, we will be terminating support for the ticket-based authentication model in Zoho Reports API by 30th of July 2013. We request API users to begin using the AuthToken in place of the temporary ticket for all API calls right away. Please make sure to replace all your application deployments using Zoho Reports API using Temporary Tickets with AuthToken by 30th of July 2013. After this deadline all your applications using Zoho Reports API with Temporary tickets will stop functioning. 

 

Deprecating ZOHO_API_KEY

It is no longer mandatory to pass the ZOHO_API_KEY parameter as part of the query string in the Zoho Reports API URL. In case you are currently using it as part of your Zoho Reports API requests you can remove this parameter, as we are deprecating the same. 

 

Using Reports Login Email Address

From now on it is recommended to use Zoho Reports Login Email Address in all your API requests URL, instead of Zoho Username.

 

Please do write to us at support@zohoreports.com for any clarifications or assistance. Looking forward to your kind co-operation in implementing this migration successfully.