---
title: "Recuperar imagem de produto"
url: "https://devcenter.stone.com.br/apis/stone-catalog/versions/502db258-cb08-4b38-8af1-b96a688b9a9e/operations/getProductImage"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-catalog/versions/502db258-cb08-4b38-8af1-b96a688b9a9e.md

# Recuperar imagem de produto

`GET` `/products/images/{imagePath}`

Operation ID: `getProductImage`

Retorna a imagem do produto a partir do caminho especificado. As imagens são servidas com cache de longa duração (1 ano).

## Path parameters

- `imagePath` (string, required) - Caminho da imagem (incluindo subpastas e nome do arquivo)

## Responses

- `200` - Imagem retornada com sucesso
- `404` - Imagem não encontrada
- `500` - Erro ao recuperar imagem

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Stone Catalog API
  version: 1.0.0
servers:
  - url: https://sdx.api.stone.com.br/v1/catalog
    description: Ambiente de Desenvolvimento (SDX)
  - url: https://api.stone.com.br/v1/catalog
    description: Ambiente de Produção (PRD)
paths:
  /products/images/{imagePath}:
    get:
      tags:
        - Products
      summary: Recuperar imagem de produto
      description: Retorna a imagem do produto a partir do caminho especificado. As
        imagens são servidas com cache de longa duração (1 ano).
      operationId: getProductImage
      parameters:
        - name: imagePath
          in: path
          description: Caminho da imagem (incluindo subpastas e nome do arquivo)
          required: true
          schema:
            type: string
            example: 550e8400-e29b-41d4-a716-446655440000/image1.jpg
      responses:
        "200":
          description: Imagem retornada com sucesso
          content:
            image/jpeg:
              schema:
                type: string
                format: binary
            image/png:
              schema:
                type: string
                format: binary
            image/webp:
              schema:
                type: string
                format: binary
            image/gif:
              schema:
                type: string
                format: binary
          headers:
            Cache-Control:
              description: Política de cache
              schema:
                type: string
                example: public, max-age=31536000, immutable
            Expires:
              description: Data de expiração do cache
              schema:
                type: string
                format: date-time
        "404":
          description: Imagem não encontrada
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: Image not found
        "500":
          description: Erro ao recuperar imagem
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: Failed to retrieve image
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Mensagem de erro
          example: Internal server error
```