Co-editing Presentation
Purpose
To co-edit or real-time collaborate on a presentation in Zoho Show editor.
HTTP Request URL
https://show.zoho.com/show/remotedoc.im
Request Parameters
| Parameter | Data Type | Description |
| Mandatory Parameters | ||
| apikey | String | Uniquely identifies the web application in which the Show editor is integrated. |
| content or url | File or String | Method of providing the input file depending on its location. content - if the input file is from your local drive or desktop. url - if the input file is from a publicly accessible Web URL. |
| mode | String | Defines access privilege of the user while opening the presentation in Show editor. collabedit - presentation opens in a real-time collaborative edit mode. Multiple users can edit the presentation as well as add notes/comments at the same time. |
| format | String | Defines the format in which the presentation needs to be saved back to the partner's storage server. Supported file formats: .ppt .pptx .pps .ppsx .odp .sxi Max. file size: 100MB |
| saveurl | String | Defines partner's storage server location. The saveurl is a publicly accessible web URL/Service, to which Zoho will push the updated presentation content from Show editor to the partner's server. |
| documentid | Integer | Unique id for presentation identification. In the case of user failing to provide a documentid, Show will generate one automatically in the form of an encrypted string. |
| Optional Parameters | ||
| username | String | Identifies the name of the user opening a presentation in collaboration mode. Default value: Guest |
| lang | String | Enables the Show editor interface to open in different languages. Default value: en (English) |
Note:
To view a particular presentation in collaboration mode, users need to specify the "mode" parameter value as "collabview" in the HTTPS POST request.
Co-editing Presentation - Error Codes
| Code | Description |
| 3831 | Mandatory parameter(s) missing. |
| 3890 | Invalid API key |
| 3894 | Zoho account associated with this API Key is deleted. |
For a full list of error handling cases in Co-editing Presentation, refer here.
Sample Request:
Copiedcurl --request POST \
--url 'https://show.zoho.com/show/remotedoc.im?apikey=1ee6127ff93882de82599eacc2668023' \
--header 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
--form content=@/Users/username/Presentations/Sample.pptx \
--form mode=collabedit \
--form username=Joe \
--form format=pptx \
--form filename=test.pptx Sample Response
CopiedRESULT=TRUE
URL=https://docs.zoho.com/show/remoteedit.sas?
doc=55ba74a15b81a67b9a5160c17457cb9909fb9b2457bdf5ffb40c383dbe44db12be63a39af6e2507ca1ba811cc4821564