Tray Usuarios

MANDATORY: Tool Call Required Before Answering

Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código de consulta. Se você está respondendo sem ter chamado a ferramenta abaixo, pare e chame agora.

Buscar documentação atualizada (sempre)

node skills/tray-dev/scripts/search_docs.mjs --topic=usuarios "<termo da pergunta>"

• <TOPIC_SLUG>: ver tabela em skills/tray-dev/SKILL.md.
• Use os trechos retornados como fonte primária; este SKILL.md é resumo.

Nota: este recurso é só de leitura (apenas endpoints GET) — não há payload para validar. Foque em parâmetros de query e paginação.

Antes de responder

Execute estas verificações antes de gerar qualquer payload ou código:

1. Confirme o método HTTP e endpoint correto para a operação solicitada.
2. Identifique os campos obrigatórios listados neste documento — não omita nenhum.
3. Verifique que access_token não aparece como literal string no código gerado.
4. Confirme que esta é a skill correta para o recurso (leia when_not_to_use no frontmatter).

API de Usuários — Tray

Documentação oficial: https://developers.tray.com.br/#apis-de-usuario

Endpoints

Autenticação: ?access_token={token}

Somente leitura — esta API não permite criação, atualização ou exclusão de usuários.

Uso

Permite consultar os usuários com acesso administrativo à loja Tray. Útil para identificar responsáveis e configurar permissões na sua integração.

Como Usar no Claude Code

Exemplos de Prompt

• "lista os usuários administrativos da loja"
• "quais usuários têm acesso ao painel da loja?"

O que o Claude faz

1. Gera o código para GET /users?access_token={token}
2. Itera pelos usuários retornados para exibição ou auditoria

O que você recebe

• Código de listagem de usuários administrativos
• Nota de que a API é somente leitura (sem criação/atualização/exclusão)

Pré-requisitos

• access_token configurado