API Home >> Writer >> API Reference >> POST Method APIs

To upload an image in your Zoho Writer account.

Request URL :  POST Method

                             XML :  http://export.writer.zoho.com/api/private/xml/image/upload?apikey=[API Key]&ticket=[Ticket]

                            JSON : http://export.writer.zoho.com/api/private/json/image/upload?apikey=[API Key]&ticket=[Ticket]

Request parameters :

To upload an image in Zoho Writer account we need to submit a form data to Writer with the following fields:

Field	Description
content	Encode the image content using base64encoding before uploading to Zoho Writer.
format	Specify the type of the image to uploaded (ex - jpg, gif).

Sample Form (POST Method)

<form method="POST"    action="http://export.writer.zoho.com/api/private/xml/image/upload?apikey=[APIKEY]&ticket=[Ticket]">

<input type="hidden" name="content" value="[base64 encoded image]">

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

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

</form>

* It is mandatory to pass the apikey and ticket parameters to access the UploadImage api.
* The image should be encoded using base64encoding before passing the image content as input parameter.


Response fields

The schema document for the API response is located at: http://export.writer.zoho.com/schema/restapi/uploadimage.xsd

Field	Description
url	Gets the image location from where it is to be uploaded to Zoho Writer.

Sample Response

The following is the sample XML response for the above method:

<?xml version="1.0" encoding="UTF-8" ?>
<response uri="/api/private/xml/image/upload">
  <result>

     <url>http://writer.zoho.com/ImageDisplay.im?name=testimage.jpg&accId=60000000145</url>

  </result>
</response>

Equivalent JSON response

{
  "response":
   {
        "uri": "/api/private/json/image/upload",
        "result":
        {   
            "url":"http://writer.zoho.com/ImageDisplay.im?name=testimage.jpg&accId=60000000145
        }
    }
}  

Errors

Uploading an image method may return general & input errors. Other HTTP error code may be 1500 & 1802.