Conversion API
Zoho Writer’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 docx) to another file format (say pdf or text).
Apart from supporting popular file formats like .docx .doc .txt .pdf .odt .sxw and .html. Zoho Writer also enable file conversion in its native .zdoc format.
Purpose
To convert a document to any Writer supported format (.docx, .doc, .pdf, .zdoc etc.)
HTTP Request URL
https://{api.office-integrator_domain}/writer/officeapi/v1/document/convert
Request Parameters
Parameter | Data Type | Description |
Mandatory Parameters | ||
apikey | 423s***** | Uniquely identifies the web application which initiates the document 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. |
output_options | { "format": <String>, "document_name": <String>, "password": <String>, "include_changes":<String>, "include_comments":<String> } | format -> Specify the output format in which the converted file needs to be stored. document_name -> Specify the name for the converted document. The below key values are optional; password-> Specify a password if you would like to protect the converted document. include_changes -> Specify how the track changed content needs to be reflected in converted file. The possible values are:
include_comments -> Specify if the comments needs to be included in the converted file or not. The possible values are:
|
Optional Parameters | ||
password | String | If the input document is password protected, specify it using this parameter. |
Note:
Users will get a response of the converted document in the form of bytes.
output_options
Parameter | Type | Possible Values | Default Value |
Mandatory Parameters | |||
format | String | docx / zdoc / doc / odt / html / pdf and more ... | docx |
document_name | String | NA | NA |
Optional Parameters | |||
password | String | NA | NA |
include_changes | String | as_markups / all / none | as_markups |
include_comments | String | all / none | all |
Conversion API - Error Codes
Code | Description |
1831 | Error occurred. Parameter value is either incorrect or invalid. |
1852 | File format you're trying to import is not supported. |
1868 | Invalid parameter name for uploaded content. |
For a full list of error handling cases in Conversion API, refer here.