All Shutterfly APIs return a common set of HTTP status codes. The response body will usually contain API-specific error messaging. If you contact Shutterfly for support, please be sure to tell us that content (message). Also, please consult the error messaging documentation as well as the documentation for the particular Shutterfly API you are using.
200
The call (usually a Read, Update or Delete type of operation) was accepted and processed normally. The request is valid and the
response body follows the API specification. The response body may describe application-level errors.
201
The call (usually a Create operation) executed successfully. The request is valid and the response body follows the API
specification. The response body may describe minor application-level errors.
400
Bad request. A basic application parameter failure. HTTP error text will state the problem, which may be application-specific. For
Call Signature, the possible problems are: app ID not known; app ID has been disabled by a Shutterfly administrator; call signature
missing; call signature invalid; missing or invalid timestamp.
Retriable:
No
401
Unauthorized. A required credential (such as an Authentication token) was not supplied, was invalid or expired, etc.
Retriable:
No
403
Forbidden. A valid credential (such as an Authentication token) was supplied, but application-level permission for the operation is
required and has not been granted.
Retriable:
No
404
Not found. The requested resource or document could not be found.
Retriable:
No
405
Method not allowed. The application attempted an HTTP method that is not supported. Usually, this means a method other than the
basic POST, GET, PUT, DELETE. Making HTTP calls to an HTTPS-only API will also result in this error.
Retriable:
No
409
Conflict. The Create operation could not be completed, because a logically equivalent object or resource already exists.
Retriable:
No
500
Internal server error. Some error condition internal to Shutterfly occured. The request should be retried later.
Retriable:
Yes
509
Bandwidth exceeded. The application has exceeded the number of calls (or perhaps the kilobytes transferred) for the current minute, hour or month. HTTP error text will state the problem.
Retriable:
Yes
Frequently Asked Questions
An API is giving me a 4xx response code, like 400. How do I figure out the real problem?
A 4xx error code normally comes with additional text in the HTTP response body, which is an error message helping you understand the problem. Please look at it.
An API is giving me a 5xx response code, like 500. How do I figure out the real problem?
A 5xx error code means a Shutterfly system error. Wait a few minutes, then retry the API call. If the problem persists, ask for help at developerhelp@shutterfly.com.
