Your Stock Photography Center
| Sell photos and buy photos - ShutterPoint Stock Photography | ||
Cart
|
Stock Photos Most Recent
Highest Rated
Most Popular
Most Viewed
Random
Featured
What's Selling
|
Search By Category
Photographer
Album
Camera
Film / Media
Lens
Filter
Event
Event Date
Venue / Location
|
|
Forum Rules
Photography General Topics
Nature & Wildlife
Landscapes
Black & White
Macros & Close-ups
People in pictures
Commercial
Editorial
|
Photo Gear Cameras
Equipment
Classifieds
ShutterPoint How can I improve this photo?
Official Announcements
Technique & Workflow How did you do that?
Editing with Photoshop
Editing (non-Photoshop)
Lighting
|
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
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
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 |
| 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 |
| rt_opt | Rating Option (possible values are blank, 0, 1, 2) - see our demo for explanation | 1 | No |
| lic | License (possible values are C for Commercial Use, and E for Editorial Use) | 1 | No |
| lic_opt | License Option (possible values are FS for Standard and Full, and F for Full only) | 2 | No |
| price | Full use price (decimal value) | 6 | No |
| model_rel | Model release (possible values are 0, 1) - see our demo for explanation | 1 | No |
| prop_rel | Property release (possible values are 0, 1) - see our demo for explanation | 1 | No |
| camera | Camera make and model (when provided, this value overwrites data obtained from EXIF) | 32 | No |
| film | Film/Media | 32 | No |
| lens | Lens | 32 | No |
| filter | Filter | 32 | No |
* 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.
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>
<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>