Our API is currently in open beta, if you encounter any issues or have a suggestion, please email us at devs@lumaprints.com. Your insights are invaluable to us.

Check image

Sandbox

https://us.api-sandbox.lumaprints.com

POST

/api/v1/images/checkImageConfig

Check if the image is sized correctly based on the provided width, height and options. You don't need to call this endpoint every time you submit an order. The submit order endpoint automatically verifies if the images meet the required dimensions.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Example

{
    "subcategoryId": "101001",
    "printWidth": "8",
    "printHeight": "8",
    "imageUrl": "https://www.example.com/image.jpg",
    "orderItemOptions": [
        1,
        11,
        21
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://us.api-sandbox.lumaprints.com/api/v1/images/checkImageConfig' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "subcategoryId": "101001",
    "printWidth": "8",
    "printHeight": "8",
    "imageUrl": "https://www.example.com/image.jpg",
    "orderItemOptions": [
        1,
        11,
        21
    ]
}'

Responses

🟢200The image is sized correctly.

application/json

Body

Example

{
    "message": "The aspect ratio of the image is the same as the ordered size. We allow a maximum of 1% difference between the aspect ratio of the image and the ordered size.",
    "imageUrl": "https://www.example.com/image.jpg",
    "recommendedWidth": 1600,
    "recommendedHeight": 2400,
    "expectedAspectRatio": "2:3",
    "actualImageWidth": 1600,
    "actualImageHeight": 2400,
    "actualImageAspectRatio": "2:3"
}

🟠400The image URL is invalid or not accessible.

🟠406The image is sized incorrectly.

Modified at 2024-01-31 17:38:16

Submit a new order.

Retrieve all categories available.