From tray-api
Uploads, updates, and removes product and variant images via the Tray API. Supports URL and Base64 uploads, position ordering, and automatic thumbnail generation.
How this skill is triggered — by the user, by Claude, or both
Slash command
/tray-api:imagens-produtosWhen to use
Use quando o desenvolvedor mencionar: imagem de produto, upload de imagem, foto do produto, POST /products/:id/images, remover imagem, formato de imagem aceito, imagem de variação, ordenar imagens ou galeria de produto.
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
- **OBRIGATÓRIO:** `node skills/tray-dev/scripts/search_docs.mjs "<termo>"` — confirme o comportamento da API antes de gerar código.
node skills/tray-dev/scripts/search_docs.mjs "<termo>" — confirme o comportamento da API antes de gerar código.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 configuradoProvides CDSS development patterns for drug interaction checking, dose validation, clinical scoring (NEWS2, qSOFA), and alert classification integrated into EMR workflows.
npx claudepluginhub tray-tecnologia/tray-api-ai-plugin --plugin tray-api