Shutterfly Open API  |  Order State


Description

This API provides real-time state of an order. Additionally, it allows for the updating of an order state when circumstances change. There is currently only one update allowed, which sets an order into preparation stage once an upload is complete. Here is the typical usage:

  1. Order is created using the order endpoint.
  2. Images are uploaded into the order using the image endpoint within the order.
  3. Order is moved from WAITING_FOR_UPLOAD state to PREPARING state using a PUT to this Order State endpoint.
  4. Order processes normally.

Note that order state updates will only succeed if the order is in WAITING_FOR_UPLOAD state and if all images are in READY state. For Shutterfly to process the order, it is mandatory that the application make this update after uploading relevant images.

Call Signature

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

Resource Path

This API uses the following resource path element:

  • /orderstate

It should appear in combination with its parent:

  • Order API - Example:
    • /order/000012345678-8000012/orderstate

Methods

  • GET - Gets the order state. The caller is returned an Atom <feed>.
  • PUT - Changes the state of an order.

Scheme

http

Host

ws.shutterfly.com

Method   Endpoint example  
  
GET http://ws.shutterfly.com/order/000012345678-8000012/orderstate
  
PUT http://ws.shutterfly.com/order/000012345678-8000012/orderstate

In the following Method detail sections, click on Method name to expand or collapse the detail.
Click here to expand/collapse all.

Method: GET

Method: PUT

Frequently Asked Questions

General

How do I do an HTTP Put?
What do I do if my PUT fails?
Please check error code. The most common reason is that not all images were successfully uploaded, please query the image state to find the failed upload and retry.
© 1999-2011 Shutterfly, Inc. All rights reserved.