curl --request POST \
--url https://kinglog.app.br/ai/query/aggregate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entity": "tasks",
"aggregate": {
"groupBy": [
"status"
],
"metrics": [
{
"fn": "count",
"field": "id"
}
]
},
"companyId": "UUID_DA_EMPRESA",
"userId": "UUID_DO_USUARIO"
}
'{
"success": true,
"data": {
"groups": []
},
"code": "SUCCESS"
}{
"success": false,
"status": 400,
"message": "Consulta inválida",
"code": "QUERY_INVALID"
}{
"success": false,
"status": 401,
"message": "Não autorizado",
"code": "UNAUTHORIZED"
}{
"success": false,
"status": 403,
"message": "Sem permissão",
"code": "FORBIDDEN"
}{
"success": false,
"status": 404,
"message": "Não encontrado",
"code": "NOT_FOUND"
}Consultas
Agregação agrupada
GROUP BY + métricas (count, sum, avg, min, max) sobre uma entidade do registry, com timeBucket para datas. Somente leitura.
POST
/
ai
/
query
/
aggregate
curl --request POST \
--url https://kinglog.app.br/ai/query/aggregate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"entity": "tasks",
"aggregate": {
"groupBy": [
"status"
],
"metrics": [
{
"fn": "count",
"field": "id"
}
]
},
"companyId": "UUID_DA_EMPRESA",
"userId": "UUID_DO_USUARIO"
}
'{
"success": true,
"data": {
"groups": []
},
"code": "SUCCESS"
}{
"success": false,
"status": 400,
"message": "Consulta inválida",
"code": "QUERY_INVALID"
}{
"success": false,
"status": 401,
"message": "Não autorizado",
"code": "UNAUTHORIZED"
}{
"success": false,
"status": 403,
"message": "Sem permissão",
"code": "FORBIDDEN"
}{
"success": false,
"status": 404,
"message": "Não encontrado",
"code": "NOT_FOUND"
}Authorizations
Todas as requisições devem incluir o JWT da conta no header Authorization no formato Bearer. Sem esse header a requisição é recusada.
Body
application/json
Nome da entidade consultável.
Example:
"tasks"
where, groupBy, metrics, orderBy e limit.
Example:
{
"groupBy": ["status"],
"metrics": [{ "fn": "count", "field": "id" }]
}
Empresa da sessão.
Example:
"UUID_DA_EMPRESA"
Usuário da sessão.
Example:
"UUID_DO_USUARIO"