tray-tecnologia MANDATORY: Tool Calls Required Before Answering
Estas chamadas são OBRIGATÓRIAS, não opcionais. Execute-as antes de gerar qualquer código ou payload. Se você está respondendo sem ter chamado as duas ferramentas abaixo, pare e chame agora.
1. Buscar documentação atualizada (sempre)
node skills/tray-dev/scripts/search_docs.mjs --topic=categorias "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela emskills/tray-dev/SKILL.md.- Use os trechos retornados como fonte primária; este SKILL.md é resumo.
2. Validar payload localmente (antes de retornar código)
node skills/categorias/scripts/validate.mjs --schema=<SCHEMA_NAME> '<payload_json>'
- Schemas disponíveis:
categoria.create,categoria.update. Use--list-schemaspara confirmar. - Exit codes:
0válido ·1inválido ·2erro de uso. - Para output programático:
--json. - Corrija todos os erros antes de retornar o código (até 3 tentativas).
Antes de responder
Execute estas verificações antes de gerar qualquer payload ou código:
- Confirme o método HTTP e endpoint correto para a operação solicitada.
- Identifique os campos obrigatórios listados neste documento — não omita nenhum.
- Verifique que
access_tokennão aparece como literal string no código gerado. - Confirme que esta é a skill correta para o recurso (leia
when_not_to_useno frontmatter).
API de Categorias — Tray
Documentação oficial: https://developers.tray.com.br/#api-de-categorias
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /categories |
Consultar árvore de categorias |
| GET | /categories/all |
Consultar dados de todas as categorias |
| GET | /categories/:id |
Consultar dados de uma categoria por ID |
| POST | /categories |
Cadastrar nova categoria |
| PUT | /categories/:id |
Atualizar dados da categoria |
| PUT | /categories/:id/order |
Atualizar ordem da categoria |
| DELETE | /categories/:id |
Excluir categoria |
Autenticação: ?access_token={token}
Nota: O endpoint de árvore de categorias (GET /categories) também está disponível publicamente sem autenticação via prefixo /web_api/categories.
Campos da Categoria
| Campo | Tipo | Descrição |
|---|---|---|
name |
string | Nome da categoria (obrigatório) |
parent_id |
number | ID da categoria pai (0 = raiz) |
description |
string | Descrição da categoria |
slug |
string | Slug da URL |
order |
number | Posição de ordenação |
has_product |
boolean | Indica se possui produtos |
Corpo da Requisição (POST/PUT)
{
"Category": {
"name": "Eletrônicos",
"parent_id": 0,
"description": "Produtos eletrônicos"
}
}
Árvore de Categorias
O endpoint GET /categories retorna a hierarquia completa com categorias aninhadas. Cada categoria inclui suas subcategorias no array children.
Reordenação
Para reordenar categorias, use PUT /categories/:id/order com o campo order indicando a nova posição.
Boas Práticas
- Crie categorias antes de produtos — o
category_idé obrigatório na criação de produto - Use a árvore pública — para vitrines, use
/web_api/categoriessem autenticação - Hierarquia — planeje a estrutura antes de criar (máximo de níveis varia por plano)
Como Usar no Claude Code
Exemplos de Prompt
- "cria a estrutura de categorias da loja: Eletrônicos > Celulares e Eletrônicos > Notebooks"
- "lista todas as categorias em formato de árvore hierárquica"
- "como crio subcategorias dentro de uma categoria existente?"
- "reordena as categorias por relevância"
O que o Claude faz
- Gera o código de criação de categoria pai (com
parent_id: 0) e subcategorias - Monta a hierarquia com chamadas sequenciais (pai antes do filho)
- Inclui o wrapper
Categorycorreto no body de cada chamada - Demonstra como buscar a árvore completa com
GET /categories
O que você recebe
- Código de criação de categorias com hierarquia correta
- Sequência de chamadas respeitando a dependência pai → filho
- Código de consulta da árvore completa
- Exemplo de reordenação via
PUT /categories/:id/order
Pré-requisitos
access_tokenconfigurado- Estrutura de categorias planejada previamente (nomes e hierarquia)