From tray-api
Uploads, updates, and removes images for products and variations via Tray API. Supports URL or Base64, image positioning (1=principal), and auto-generated thumbnails. Use for product galleries or variant photos.
npx claudepluginhub tray-tecnologia/tray-api-ai-plugin --plugin tray-apiThis skill uses the workspace's default tool permissions.
> Execute estas verificações antes de gerar qualquer payload ou código:
Monitors deployed URLs for regressions after deploys, merges, or upgrades by checking HTTP status, console errors, network failures, performance (LCP/CLS/INP), content, and API health.
Share bugs, ideas, or general feedback.
Execute estas verificações antes de gerar qualquer payload ou código:
access_token não aparece como literal string no código gerado.when_not_to_use no frontmatter).Documentação oficial: https://developers.tray.com.br/#apis-de-imagens-de-produtos-e-variacoes
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /products/:id/images | Cadastro e atualização de imagem do produto |
| POST | /variants/:id/images | Cadastro e atualização de imagem da variação |
| POST | /images/remove | Remoção de imagens |
Autenticação: ?access_token={token}
As imagens podem ser enviadas de duas formas:
{
"ProductImage": {
"image_url": "https://exemplo.com/imagem.jpg"
}
}
{
"ProductImage": {
"image_base64": "data:image/jpeg;base64,/9j/4AAQSk..."
}
}
| Campo | Tipo | Descrição |
|---|---|---|
image_url | string | URL pública da imagem |
image_base64 | string | Imagem codificada em Base64 |
position | number | Posição/ordem da imagem (1 = principal) |
Após o upload, a Tray gera automaticamente thumbnails em 3 tamanhos:
| Tamanho | Uso |
|---|---|
| 30px | Miniatura/ícone |
| 90px | Lista de produtos |
| 180px | Exibição média |
Cada thumbnail é disponibilizado em HTTP e HTTPS.
Para remover imagens, envie um POST para /images/remove com o ID da imagem.
position (1 = principal, 2, 3... para as demais)/products/:id/images) do de variação (/variants/:id/images){"ProductImage": {...}} correto/images/removeaccess_token configurado