API Errors

When something goes wrong with your request an error message is returned to signal the issue along with the respective HTTP status code.

400 Bad Request

Requesting the server for something that it does not understand or is invalid

Examples

    {"error":400,"message":"Invalid expiration date"}
    {"error":400,"message":"Bad or invalid request received"}
                

401 Unauthorized

You will get this error when the authentication fails. This happens when the user provides a bad access key or a bad signature.

Examples

    {"error":401,"message":"Authentication failed: bad access key"}
    {"error":401,"message":"Authentication failed: bad signature"}
                

402 Payment Required

A premium subscription is needed to request transformations from the server.

Example

    {"error":402,"message":"No premium subscription active"}
                

404 Not Found

Trying to retrieve a nonexistent or deleted resource results in a 404.

Examples

    {"error":404,"message":"Requesting for something nonexistent"}
    {"error":404,"message":"The resource you are trying to retrieve was deleted"}
                

500 Internal Server Error

If a server error occur when processing your request you are notified as our support team. You may still contact us to report the problem.

Examples

    {"error":500,"message":"Failed access key confirmation"}
    {"error":500,"message":"Failed to retrieve request"}
                

501 Not Implemented

When you request for some functionality that is not implemented you will get this error.

Example

    {"error":501,"message":"The server does not support the functionality required to
                            fulfill the request"}