Open Sumo Paint  |  Community Mode  |  Forgot Your Password?  |  Register Now!  |  Why Register?
Login remember

Sumo Paint API

Add Sumo Paint to your own website or application

We are more than happy to provide an API for your own services or applications. You can use it to open and edit any image in Sumo Paint and save it back to your service or application. Here you can find all the info you need for the integration.

NEW! We have launched free Sumo Partner tools for easier integration.

Opening images with GET parameter

Open any image from any website with url-parameter:
http://www.sumopaint.com/app/?url=http://www.snap.fi/image.jpg

Code example:

<a href="http://www.sumopaint.com/app/?url=url_to_open">Open</a>

You can open images to new window by adding a simple javascript function:
Open the same image in new window

Code example:

<a href="javascript:window.open('http://www.sumopaint.com/app/?url=url_to_open','sumopaint','resizable=1')">Open</a>

You can also change the image title by passing optional parameters:
(Click the image to open)

Code example:

<a href="javascript:window.open('http://www.sumopaint.com/app/?url=url_to_open&title=image_title','sumopaint','resizable=1')"><img src="http://www.snap.fi/image.jpg"></a>

If you want to save the image back to your system, you need to provide at least service and target paramaters. You can also pass any optional data with opt parameter. Read more from below (Saving images back to your service).

Opening images with POST parameter

You can also use POST method for opening images. You can use the same parameters (url,title,service,target,opt) with both GET and POST methods.

Here is a simple HTML form for sending POST data:

  

Code example:

<form method="POST" action="http://www.sumopaint.com/app/?"><input type="text" name="url" value="url_to_open"><input type="submit"/></form>

Saving images back to your service

If you want to get the modified image back to your service, you need to specify at least url, service and target parameters when you open the image.

You will receive url, title, service, data and opt parameters with POST method to specified target url. Data parameter will include the image data in encoded format (base 64). You need to decode the data before saving (API example on the right).

Please read the terms and privacy policy for more info about the service.

API Parameters
Opening image (GET & POST)

urlimage url (for ex. "http://www.snap.fi/image.jpg")
titleimage title (for ex. "My Family")
serviceyour service name (for ex. "Facebook")
targettarget url for data (for ex. http://www.yoursite.com/saveimage.php)
optyour optional data (for ex. image id, user id, redirect url etc.)

Saving image back to your service (POST)

urlimage url (for ex. "http://www.snap.fi/image.jpg")
titleimage title (for ex. "My Family")
serviceyour service name (for ex. "Facebook")
databitmap data (read Saving image chapter below for more info)
optyour optional data (for ex. image id, user id, redirect url etc.)

API Example (PHP)
Here you can find a simple example how to use our API for your own service:

Download commented source files (zipped)

<html>
<head><title>Sumo Paint API demo</title></head>
<body>

<form action="http://www.sumopaint.com/app/?">
<input type="hidden" name="url" value="http://www.sumopaint.com/images/misc/api.jpg" />
<input type="hidden" name="title" value="Future Buildings" />
<input type="hidden" name="service" value="Sumo Paint API Page" />
<input type="hidden" name="target" value="http://www.sumopaint.com/api/index.php#mod" />
<input type="image" src="../images/misc/api.jpg" />
</form>

<?php
   if(isset($_POST["data"])) {
      $file = "path_where_to_save".uniqid().".png";
      $title = $_POST["title"];
      $handle = fopen($file,"w");
      fwrite($handle, base64_decode($_POST["data"]));
      fclose($handle);
      print "Modified image ($title):<br><a name='mod'><img src='$file'></a>";
   }
?>

</body>
</html>

Click the image below to modify in Sumo Paint:

About Sumo
Latest News
Latest Features
Links about Sumo
Terms of Use
Sumo Paint API
Get Started!
Register Sumo Account
Why Register with Sumo?
Sumo Support
Open Sumo Paint
Download Firefox Addon
Explore Sumo
Random Images
Random Artist
Random Gallery
Latest Artwork
Popular Artwork
Get Active
Register Sumo Account
Send Feedback to Us
Invite your friends
Support Sumo Development
Sumo Pro
Sumo Support
Sumo Paint Help
Latest Features
Latest News
Forgot Your Password?
Press Material
Home  |  Images  |  Favorites  |  Community  |  Features  |  News  |  Store
change language
Copyright © 2008 - 2010 Sumo Ltd. All rights reserved.  |  Terms of Use  |  Privacy Policy  |  Twitter  |  Facebook  |  YouTube  |  MySpace