Product Image Details

🔒

Requires read_product access scope. More access scope

The Get Product Image Details API retrieves detailed information about a specific product image. By providing both the product_id and image_id, users can fetch attributes of a specific image, such as its dimensions, position, and alternate text. This API is particularly useful for managing product images or troubleshooting image-related issues.This API is especially useful for:

  1. Retrieve detailed metadata for a specific product image to support catalog management.
  2. Identify and update specific product images based on their attributes.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Path Parameters

FieldTypeRequiredExampleDescription
product_idstringYes636a07da-39eb-4829-bde9-b65fae1c28b0The unique identifier of the product.
image_idstringYes91d032e7-bbc8-47e4-8668-9ba6fe714de6The unique identifier of the image.

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Success Response

Field Type Example Description
image.id string 91d032e7-bbc8-47e4-8668-9ba6fe714de6 The unique identifier for the image.
image.product_id string 636a07da-39eb-4829-bde9-b65fae1c28b0 The unique identifier for the product associated with the image.
image.position integer 1 The position of the image relative to other images in the product gallery.
image.src string //cdn.shoplazza.com/efd33b921cacd5311a32dd03a9bc8740.png The URL of the image.
image.width integer 1588 The width of the image in pixels.
image.height integer 2246 The height of the image in pixels.
image.alt string "" Alternative text for the image (used for accessibility or descriptions).
image.created_at string 2024-04-08T07:13:28Z The timestamp indicating when the image was created.
image.updated_at string 2024-04-08T07:13:28Z The timestamp indicating when the image was last updated.

error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsArray["Context"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorArray "store is not active"Indicates an error encountered during the process.

Error Details

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized
422Product or Image Not FoundThe product or image ID provided in the request does not exist.{ "errors": ["Record not found"] }
Invalid or empty product_idorimage_idMissing required product_id, image_id, or incorrect UUID types.{ "errors": [ "ProductId must be a valid UUID", "ImageId must be a valid UUID"]}
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!