Product images

Shoptet maintains product images in original size and creates standardised versions called “image cuts” that are
pre-generated and stored for quick access. The available cuts are consistent across all shops, though sizes may vary
based on template requirements. These cuts are defined in the
Image Cuts code list.

Image cut information

The eshop info endpoint
(/api/eshop?include=imageCuts) provides image cut details including actual dimensions and base URL paths.
Each cut contains:

• name — the cut identifier (e.g. detail)
• width / height — pixel dimensions
• urlPath — direct access URL (not cached)
• cdnPath — CDN-cached base URL

{
    "name": "detail",
    "width": 360,
    "height": 270,
    "urlPath": "https://fenix.myshoptet.com/user/shop/detail/",
    "cdnPath": "https://cdn-api.myshoptet.com/usr/fenix.myshoptet.com/user/shop/detail/"
}

URL path selection

Use urlPath when:

• You need an immediately up-to-date image
• You are processing the image server-side and will not display it to users
• The image is fetched only once — urlPath responses are not cached

Use cdnPath when:

• You are rendering image URLs in a frontend, mobile app, or alternative storefront
• Users will display the images — CDN responses are cached with lower latency

Constructing image URLs

Append an image filename to the appropriate cut’s base URL. Four valid combinations exist:

• urlPath + name — original filename, no cache
• urlPath + seoName — SEO filename, no cache
• cdnPath (big cut) + cdnName — signed, CDN-cached, big cut
• cdnPath (any cut) + signedCdnNames[cutCode] — signed, CDN-cached, cut of your choice

Each image object returned by product and order endpoints contains the following fields:

{
    "name": "106.png",
    "description": "shamrock 2115611 640",
    "seoName": "106_shamrock-2115611-640.png",
    "cdnName": "106_shamrock-2115611-640.png?ff=1&x=1024&y=768&q=85&ts=5b2a41f5&sg=cce48299",
    "signedCdnNames": {
        "big":          "106_shamrock-2115611-640.png?ff=1&x=1024&y=768&q=85&ts=5b2a41f5&sg=cce48299",
        "detail":       "106_shamrock-2115611-640.png?ff=1&x=423&y=318&q=85&ts=5b2a41f5&sg=265606b9",
        "category":     "106_shamrock-2115611-640.png?ff=1&x=216&y=105&q=85&ts=5b2a41f5&sg=8489ad00",
        "admin_detail": "106_shamrock-2115611-640.png?ff=1&x=140&y=100&q=85&ts=5b2a41f5&sg=233ee497",
        "related":      "106_shamrock-2115611-640.png?ff=1&x=100&y=100&q=85&ts=5b2a41f5&sg=c2dd6679",
        "detail_small": "106_shamrock-2115611-640.png?ff=1&x=290&y=218&q=85&ts=5b2a41f5&sg=54eaf478",
        "detail_alt_1": "106_shamrock-2115611-640.png?ff=1&x=677&y=507&q=85&ts=5b2a41f5&sg=33cb7034"
    },
    "changeTime": "2025-11-14T09:22:13+01:00"
}

cdnName contains a pre-signed filename for the big cut. Combine it with the big
cut’s cdnPath from /api/eshop?include=imageCuts to form the full URL.

signedCdnNames is a map keyed by cut code. Each value is a pre-signed filename for that specific cut —
combine it with the matching cut’s cdnPath to form the full URL. Use this field when you need a specific
cut other than big.

The signed query parameters (ff, x, y, q, ts,
sg) are computed by Shoptet and must not be modified. ts is derived from the image’s last
change time and ensures cache invalidation whenever the image is replaced. signedCdnNames is
null in the rare case that cut configuration is temporarily unavailable; fall back to cdnName
in that case.

URLs in the older bare-hash format (e.g. 106_shamrock-2115611-640.png?5b2a41f5) that were returned by
earlier API versions remain valid on the CDN.

Variant and order images

Product variants can have a default image specified in data.variants[].image (matched against the image
list by the name field). Order details include data.items[].mainImage representing the
variant’s or product’s default image. Product lists similarly include data.products[].mainImage for each
product’s primary image. All of these image objects contain cdnName and signedCdnNames as
described above.

What changed from the previous version

cdnName now carries a signed URL (previously a bare seoName?hexTimestamp), and
signedCdnNames is a new field that gives you a ready-to-use signed URL for every available cut so you no
longer have to use big for everything.