Shutterfly Open API  |  Go To Shutterfly UE


Description

Take the end user to a Shutterfly User Experience. That is, take the user's Web browser to a workflow on the Shutterfly Web site, usually a workflow to create a personalized Shutterfly product.

The protocol has two variations; your application may use one or the other, at different time:

Single Resource may be viewed as a simplified version of Multiple Resource.

Call Signature

Application ID and call signature are required. Please see Call Signature documentation for more details.

Single Resource

With this variation, your application constructs a 'start URL' like the following:

http://www.shutterfly.com/go2ue/start.sfly?target=xxxx&resourceHref=xxxx

The target and resourceHref are variables. Your app sends the user's Web browser to the constructed URL by means of a link, a redirect, or whatever you prefer. The user will see a workflow on the Shutterfly web site, and interact with it to complete the desired work.

The URL parameters have the following meaning:

target
Description: The desired Shutterfly UE (User Experience).
Required: Yes
Example: OP
Possible values: OP = OrderPictures; PHOTOBOOK = Photo Book creation; CARD = Card creation; CALENDAR = Calendar creation; COLLAGE_POSTER = Collage Poster creation; PHOTO_GIFT = Photo Gift creation; DIGITAL_SCRAPBOOK = Digital Scrapbook creation; STORE = The Shutterfly Store.
resourceHref
Description: A single Shutterfly resource, such as an album or image URL, which will be passed to the target workflow.
Required: Varies by target workflow
Example: http://ws.shutterfly.com/userid/00001234567/albumid/00005678
Possible values: for target=OP, supply a Shutterfly Open API album URL or image URL

Example (before URL encoding, and all on one line):

http://www.shutterfly.com/go2ue/start.sfly?target=OP
&resource=http://ws.shutterfly.com/userid/00001234567/albumid/00005678

Note: This is a simplified example. You must supply authentication parameters, and a Call Signature as previously mentioned.

Multiple Resource

With this variation, your application can specify multiple resources to the desired Shutterfly UE. For example, you could pass multiple album or image URLs, or a mixture, to the OP (OrderPictures) workflow.

Begin by storing your target and resource parameters in the UE Parameter API. That API will construct the 'start URL' for you, telling you what it is. (See its documentation for details.) Your app sends the user's Web browser to the constructed URL by means of a link, a redirect, or whatever you prefer. The user will see a workflow on the Shutterfly web site, and interact with it to complete the desired work.

How it Ends

The user ends the Shutterfly workflow by closing her browser. There is no callback to your site or application. If you would like the user to continue with your site or application when she is done with Shutterfly, open the Shutterfly workflow in a separate browser window.

© Copyright Shutterfly 1999-2009. All rights reserved.