Skip to content

Configurar permissão de usuário

POST
/tenant/datamart/{id}/user

Cria ou atualiza a permissão de um usuário específico para acessar uma tabela do datamart.

Comportamento

Se já existir uma permissão para a combinação (datamart + tabela + usuário):

  • A permissão é atualizada com os novos valores

Caso contrário:

  • Uma nova permissão é criada

Campos de Segurança

allowed (Acesso à Tabela)

Valor Comportamento
true Usuário pode visualizar a tabela
false Usuário NÃO pode ver a tabela (bloqueado)

allow_export (Exportação)

Valor Comportamento
true Usuário pode exportar dados (CSV, Excel)
false Usuário apenas visualiza, não exporta

hidden_columns (Colunas Ocultas)

Lista de nomes de colunas que o usuário não deve ver.
Exemplo: ["salario", "cpf", "endereco"]

filters (Filtros de Linha - RLS)

Filtros que restringem quais registros o usuário pode ver.
Cada filtro tem:

Campo Descrição Exemplo
column Nome da coluna regiao
operator Operador =, !=, >, <, >=, <=, IN
value Valor Sul

Exemplo prático: Um vendedor só vê vendas da sua região:

"filters": [
  {"column": "regiao", "operator": "=", "value": "Sul"}
]

expires_in (Expiração)

Data/hora em que o acesso expira automaticamente.
Útil para acessos temporários (consultores, estagiários).

Mensagens de Erro

Mensagem Causa
Datamart not found ID do datamart não existe
Table not found tableId não existe no tenant
Invalid userId Usuário não existe ou inativo

Autorizações

tenantBearerAuth

Token de acesso do tenant

TipoHTTP (bearer)

Parâmetros

Parâmetros de Caminho

id*

ID do datamart

Tipointeger
Obrigatório
Example1

Corpo da Requisição

application/json
JSON
{
"userId": 10,
"tableId": 100,
"allowed": true,
"allow_export": true,
"expires_in": null,
"hidden_columns": [
],
"filters": [
]
}

Respostas

Permissão salva com sucesso

application/json
JSON
{
"status": "success",
"data": true
}

Playground

Autorização
Variáveis
Chave
Valor
Corpo

Exemplos

Desenvolvido por VitePress OpenAPI