From tray-api
Manages Tray store customers via REST API: list with filters/pagination, retrieve by ID, create, update, delete. Supports CPF/CNPJ for physical/juridical persons, Brazilian validations, newsletter opt-in.
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).node skills/clientes/scripts/validate.mjs '<payload_json>'
para confirmar a estrutura do payload que vai gerar. O validador checa
apenas estrutura (campos obrigatórios, tipos e campos desconhecidos),
nunca valores reais — então monte um payload sintético com placeholders
sempre que os valores vierem de variáveis de ambiente, da entrada do
usuário ou de outras chamadas. Exemplo:
node skills/clientes/scripts/validate.mjs '{"Customer":{"name":"<nome>","email":"<email>"}}'.
Corrija todos os erros antes de retornar o código ao usuário. Até 3
tentativas — se persistir, explique o problema ao usuário.Documentação oficial: https://developers.tray.com.br/#api-de-clientes
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /customers | Listagem de clientes com paginação e filtros |
| GET | /customers/:id | Consultar dados do cliente por ID |
| POST | /customers | Cadastrar novo cliente |
| PUT | /customers/:id | Atualizar dados do cliente |
| DELETE | /customers/:id | Excluir cliente |
Autenticação: ?access_token={token}
| Campo | Tipo | Descrição |
|---|---|---|
name | string | Nome completo |
email | string | E-mail (obrigatório, único) |
cpf | string | CPF (pessoa física) |
cnpj | string | CNPJ (pessoa jurídica) |
rg | string | RG |
phone | string | Telefone fixo |
cellphone | string | Celular |
birth_date | date | Data de nascimento (YYYY-MM-DD) |
gender | string | Gênero |
company_name | string | Razão social (PJ) |
newsletter | number | 0=não inscrito, 1=inscrito na newsletter |
created_at | datetime | Data de cadastro |
{
"Customer": {
"name": "João Silva",
"email": "joao@exemplo.com",
"cpf": "12345678901",
"phone": "1133334444",
"cellphone": "11999998888",
"newsletter": 1
}
}
limit (máximo 50, padrão 30), page.
tray-enderecos-clientetray-perfis-clientenewsletter: 1 apenas com consentimentocustomer para receber notificações de alteraçõesCustomer e validação de CPF/CNPJemail, cpf, newsletter) para buscas específicas{"Customer": {...}} e campos obrigatóriosnewsletter)access_token configurado