API de Tabelas Personalizadas
Descrição
A API de Tabelas Personalizadas permite criar, ler, atualizar e eliminar dados em tabelas definidas pelo utilizador.
dica
Se estiver a trabalhar dentro de workspaces ou automações no Skills Workflow, prefira usar os métodos do SDK (SW.Document.CustomTable.*) documentados na Referência do SDK, em vez de chamar a API diretamente.
Todos os endpoints exigem autenticação através do cabeçalho X-AccessToken.
Base path: api/v3
Endpoints
| Método | Rota | Descrição |
|---|---|---|
| GET | /custom-tables | Lista todas as tabelas personalizadas |
| GET | /custom-tables/{tableName} | Obtém o esquema da tabela |
| GET | /custom-tables/{tableName}/rows/values | Obtém todas as linhas |
| POST | /custom-tables/{tableName} | Cria a tabela ou adiciona colunas |
| PUT | /custom-tables/{tableName}/rows | Insere ou atualiza linhas |
| DELETE | /custom-tables/{tableName}/rows | Remove linhas |
| DELETE | /custom-tables/{tableName} | Remove a tabela |
| GET | /custom-tables/{tableName}/export | Exporta para JSON |
| PUT | /custom-tables/{tableName}/import | Importa a partir de JSON |
Ler dados através de queries
Nas queries de Maintenance → Queries, use CustomTable como namespace.
SELECT Oid, Name, Price, IsActive
FROM [customtables].[ProductCatalog]
WHERE IsActive = 1
ORDER BY Name