Saltar al contingut principal
GET

Obtenir la imatge principal d'un producte

Scope:inventory:products.read
https://api.holded.com/api/v2/products/{productId}/image

Retrieves the main (first) image of a product. Returns 404 if the product has no images.

Paràmetres

Paràmetres de ruta

productIdstringobligatori

ID del producte (ObjectId hexadecimal de 24 caràcters)

Petició

python
import requests

url = "https://api.holded.com/api/v2/products/{productId}/image"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respostes

Resposta

json
{
  "id": "507f1f77bcf86cd799439011",
  "position": 1,
  "description": "string",
  "url": "string",
  "sizes": {
    "original": {
      "url": "string",
      "width": 0,
      "height": 0
    },
    "large": {
      "url": "string",
      "width": 0,
      "height": 0
    },
    "medium": {
      "url": "string",
      "width": 0,
      "height": 0
    },
    "small": {
      "url": "string",
      "width": 0,
      "height": 0
    },
    "thumbnail": {
      "url": "string",
      "width": 0,
      "height": 0
    }
  }
}

Respostes exitoses

200Imatge principal trobadaapplication/json
object
idstringrequired

Unique identifier of the image

positionintegerrequired

Position of the image in the product gallery (1-indexed)

descriptionstring | nullrequired

Alt text or description of the image

urlstring | nullrequired

Primary image URL (original size or raw URL)

sizesobjectrequired

Available image sizes with URLs and dimensions

originalobject | null
largeobject | null
mediumobject | null
smallobject | null
thumbnailobject | null

Respostes d'error

401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Producte no trobat o sense imatgesapplication/json
429Límit de sol·licituds exceditapplication/json