Conversion API
Zoho Show’s conversion API lets you easily integrate document conversion functionality to web applications and content management systems.
The conversion API allows you to convert a file format (say pptx) to another file format (say ppsx or odp).
Zoho Show supports all popular file formats for conversion like pptx, pps, ppsx, odp, pdf and sxi.
Purpose
To convert a document to any Show supported format.
HTTP Request URL
https://{api.office-integrator_domain}/show/officeapi/v1/presentation/convert
Request Parameters
| Parameter | Data Type | Description |
| Mandatory Parameters | ||
| apikey | 423s***** | Uniquely identifies the web application which initiates the presentation conversion request. |
| document or url | File or String | Method of providing the input file depending on its location. document - if the input file is from your local drive or desktop. url - if the input file is from a publicly accessible Web URL. |
| format | String | Output file format, to which the file should be converted. Supported file formats are listed here. |
| Optional Parameters | ||
| password | String | Specify the password for the input file when importing a password-protected document using this parameter. |
Note:
Users will get a response of the converted presentation in the form of bytes.
Conversion API - Error Codes
| Code | Description |
| 3106 | Conversion failed |
| 3835 | File size limit exceeded. The maximum allowed size is 100 MB |
| 3845 | Content type did not match |
For a full list of error handling cases in Conversion API, refer here.
Sample Request
Copiedcurl --request POST \
--url 'https://api.office-integrator.com/show/officeapi/v1/presentation/convert?apikey=423s*****' \
--header 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
--form document=@/Users/username/Presentation/Sample.pptx \
--form format=pptx \
--form password=a1b2c3****