From tray-api
Manages Tray product characteristics (properties) including creation, update, listing, and deletion. Works with global reusable characteristics and product-specific attribute values like color, size, material, or voltage.
How this skill is triggered — by the user, by Claude, or both
Slash command
/tray-api:caracteristicasWhen to use
Use quando o desenvolvedor mencionar: característica, propriedade de produto, atributo customizado, POST /products/:id/characteristics, material, voltagem, campo técnico de produto ou especificação técnica.
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-caracteristicas
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /products/:product_id/properties | Listar características de um produto |
| POST | /products/:product_id/properties | Cadastrar ou atualizar característica no produto |
| POST | /properties | Criar característica global (reutilizável em vários produtos) |
| DELETE | /products/:product_id/properties/:id | Excluir característica de um produto |
Autenticação: ?access_token={token} em todas as chamadas.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | — | ID da característica (retornado pela API) |
property | string | Sim | Nome da característica (ex: "Cor", "Material") |
value | string | Sim | Valor da característica (ex: "Azul", "Algodão") |
product_id | number | Sim | ID do produto associado |
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome da característica global |
presentation | string | Não | Tipo de apresentação (ex: "select", "text") |
{
"Property": {
"property": "Cor",
"value": "Azul"
}
}
{
"Property": {
"name": "Material",
"presentation": "select"
}
}
| Operação | Código | Mensagem |
|---|---|---|
| Criação | 201 | {"message": "Created", "id": 123, "code": 201} |
| Atualização | 200 | {"message": "Saved", "id": 123, "code": 200} |
| Exclusão | 200 | {"message": "Deleted", "id": 123, "code": 200} |
{
"Properties": [
{
"Property": {
"id": "1",
"property": "Cor",
"value": "Azul",
"product_id": "123"
}
},
{
"Property": {
"id": "2",
"property": "Material",
"value": "Algodão",
"product_id": "123"
}
}
]
}
POST /properties para padronizar nomes e evitar duplicidadePOST /properties quando a padronização é necessáriaPOST /products/:id/propertiesProperty correto em cada chamadaGET /products/:id/propertiesproduct_id disponívelaccess_token configuradonpx claudepluginhub tray-tecnologia/tray-api-ai-plugin --plugin tray-apiProvides CDSS development patterns for drug interaction checking, dose validation, clinical scoring (NEWS2, qSOFA), and alert classification integrated into EMR workflows.