Your Stock Photography Center

Buy Photos | Sell Photos

	Lightbox \| Cart \| Login \| Help
	Photos Learning Forums My Account

API

ShutterPoint API allows a third party web site or an application to submit image files to ShutterPoint on behalf of the end user. The API is an HTTP form post to the ShutterPoint online system that consists of name-value pairs described below.

API supports JPEG or TIFF images. We recommend submitting images with IPTC profiles to simplify data tagging after upload.

Overview
HTTP Post Parameters
Response

Overview

To submit an image file to ShutterPoint, your application or website needs to perform the following steps:

Authenticate a user as a registered ShutterPoint photographer
Obtain a list of existing user albums
Collect user input and perform HTTP post to ShutterPoint
Obtain and parse the result of the operation (provided as XML)
Provide a user with the user-friendly information about the submission result

The HTTP post destination is:

http://www.shutterpoint.com/ws/upload.cfm

We have provided a sample web form that can be used as a starting point in developing your own interface to ShutterPoint. The form is fully functional and can be viewed at the URL below:

http://www.shutterpoint.com/ws/uploadAPIDemo.cfm

HTTP Post Parameters

Field Name	Description	Length	Required
username	ShutterPoint username	12	Yes
email	E-Mail address associated with the username	48	Yes
filename	File to upload		Yes
album_id	Numeric ID of the existing album to place the image in	3	Yes *
new_album_name	Name of the new album to place the image in	50	Yes *
ui	Name of your website or application that implements the API	32	Yes

* Provide either an album_id or new_album_name.
Use http://www.shutterpoint.com/Synd-UserAlbums.rss.cfm?user_id=USERNAME to obtain user album id's in RSS format.

Response

Result of the image submission is presented as XML with the following structure:

<result>
     <status>Status code - negative values indicate failures</status>
     <imageId>Image ID of the newly added file, blank if failure</imageId>
     <resultText>"OK" without quotes for success, error text if failure</resultText>
     <viewURL>URL where the image can be viewed, blank if failure</viewURL>
     <editURL>URL where the image can be edited, blank if failure</editURL>
</result>

Content Filter: Moderate | Strong | None