Zoho - Trademark
Blogs
  Forums 
Show Home  Toll Free : 888 900 9646

<< API Home

Zoho Show Remote API



The Zoho Remote Application Programming Interface (API) lets any third-party application use the feature-rich editor of Zoho Show for viewing presentations. Remote edit of presentations is not supported as of now.  All the viewed presentations are saved in Zoho Show servers.

 
Viewing a Remote Presentation in Zoho Show


Using multi-part form submit



To push the presentation from remote server (for making it load on the Zoho Show editor), submit a multi-part form-data to Zoho Show with the following fields

Field
Description
contentactual presentation content
filename
filename of the presentation with extension
idunique id that will be submitted while viewing the presentation (for reference)
formatimplies the presentation format (examples: ppt, pps )
persistence(optional)if this parameter is not passed or set to false, the presentation pushed to ZohoShow will be editable only once. When the user exits the browser window, it will be automatically deleted.



Sample multipart form


<form method="POST" action="http://show.zoho.com/remotedoc.im?output=view&apikey=<Api Key>" enctype="multipart/form-data" target="_self">

File : <input type="file" name="content" size="38"> <br>

<input type="hidden" name="id" value="12345678">

<input type="hidden" name="format" value="ppt">

<input type="submit" value="View" class="divbutton" name="submit">

</form>



* In order to view a presentation in Zoho Show, it must be submitted as multi-part form data either from the client side or it can be done as an emulated multi-part form submission on the server side of the remote server.


API URL


To access the multi-part form based remote API, the users should post to the following URL format mentioned below :

http://show.zoho.com/remotedoc.im?apikey=<apikey>&output=view


The output parameter decides the format in which output will be sent. By passing 'view' as the output value the response will be javascript code snippet which automatically loads Zoho Show editor with the presentation content opened for viewing.

view -- JavaScript code snippet that loads the Zoho Show

url -- outputs a URL which contains encrypted Id for the presentation to be viewed

by default the response will be a URL




Response Format for URL request:


URL=[url value1]

WARNING=[warning message]

RESULT=[TRUE/FALSE]


RESULTfield indicates the status of the action

Sample Response:


URL=http://show.zoho.com/remoteview.im?doc=C77076EG003waI770c1
WARNING=
RESULT=TRUE



Using normal form submit


To push the presentation from the remote server, submit a form to Zoho Show with the following form fields.

Field
Description
url
url from which zoho show can fetch the presentation
Note : it is mandatory to specify the absolute path of the document in url parameter with proper file extension.
filenamefilename of the presentation with extension
idunique id that will be submitted while saving the presentation (reference)
formatimplies the presentation format (examples: ppt, pps )
persistence(optional)if this parameter is not passed or set to false, the presentation pushed to ZohoShow will be viewable only once, when the user exits the browser window it will be automatically deleted


Sample form


<form method="POST" action="http://show.zoho.com/remotedoc.im?output=view&apikey=<Api Key>" target="_self">

<input type="hidden" name="url" value="[REMOTE PRESENTATION URL]">

<input type="hidden" name="filename" value="myshow.ppt">

<input type="hidden" name="id" value="12345678">

<input type="hidden" name="format" value="ppt">

<input type="hidden" name="persistence" value="true">

<input type="submit" value="View" class="divbutton" name="submit">

</form>



* In order to view a document in Zoho Show, it must be submited as form data either from the client side or it can be done as a emulated form submission on the server side of the remote server.

http://show.zoho.com/remotedoc.im?output=view

The output parameter decides the format in which output will be sent. By passing 'view' as the output value the response will be javascript code snippet which automatically loads the Zoho Show editor with the presentation content opened for viewing.

editor -- JavaScript code snippet that loads the Zoho Show

url -- outputs a URL which contains encrypted Id for the presentation to be viewed

by default the response will be a URL


Response Format for URL request:

URL=[url value1]

WARNING=[warning message]

RESULT=[TRUE/FALSE]


RESULT field indicates the status of the action

Sample Response:

URL=http://show.zoho.com/remoteview.im?doc=C77076EG003waI770c1
WARNING=
RESULT=TRUE



Zoho API is an easy way to integrate Zoho Services into your application. Do have a go at the APIs by signing up for the key now. If you have any further questions regarding the Zoho API, write to us at api@zoho.com.

Note : It is mandatory to have the remote server address set to port number 80 for all the upload and download operations.