MANDATORY: Tool Call Required Before Answering
Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código ou payload. 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=parceiros "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela emskills/tray-dev/SKILL.md.- Use os trechos retornados como fonte primária; este SKILL.md é resumo.
Nota: este recurso ainda não tem
validate.mjslocal. Você é responsável por revisar campos obrigatórios contra a doc retornada e o resumo abaixo.
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 Parceiros — Tray
Documentação oficial: https://developers.tray.com.br/#apis-de-parceiros
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /partners |
Listagem de parceiros |
| GET | /partners/:id |
Consultar dados do parceiro |
| POST | /partners |
Cadastrar parceiro |
| PUT | /partners/:id |
Atualizar dados do parceiro |
| DELETE | /partners/:id |
Excluir parceiro |
Autenticação: ?access_token={token}
Exemplo de Criação
{
"Partner": {
"name": "Parceiro Exemplo",
"email": "parceiro@exemplo.com"
}
}
Paginação
limit (máximo 50, padrão 30), page.
Como Usar no Claude Code
Exemplos de Prompt
- "cadastra um parceiro revendedor com nome e e-mail"
- "lista todos os parceiros ativos da loja"
- "atualiza os dados de contato do parceiro ID 10"
O que o Claude faz
- Gera o código de criação com wrapper
Partner - Gera o código de listagem e atualização de parceiros existentes
- Inclui paginação na listagem
O que você recebe
- Código de criação com
{"Partner": {"name": "...", "email": "..."}} - Código de listagem com paginação
- Código de atualização e exclusão
Pré-requisitos
access_tokenconfigurado