Autenticação
Usuário, workspace, limites e uso
Retorna o usuário autenticado, o workspace, os limites do plano, o uso atual e se o 2FA está ativo.
Sessão do painel
Sessão
Exemplo de requisição
curl -X GET "https://seu-dominio/auth/me" \
-H "Cookie: vertice_session=..."
const response = await fetch('https://seu-dominio/auth/me', {
method: 'GET',
headers: {
credentials: 'include',
},
});
const payload = await response.json();
console.log(payload);
Entenda
Conceituação
Retorna o usuário autenticado, o workspace, os limites do plano, o uso atual e se o 2FA está ativo.
Respostas de sucesso seguem { "data": ... }; erros seguem { "error": { "code", "message" } }. Operações de escrita exigem escopo write quando autenticadas por API key.
Contrato
Atributos
Header
Cookie
string
obrigatório
Cookie vertice_session emitido no login.
Contrato
200
Resposta
{
"data": {
"user": {
"id": "usr_...",
"name": "Isaias Silva",
"email": "voce@empresa.com",
"role": "owner"
},
"tenant": {
"id": "tnt_...",
"name": "Nimbus Labs",
"plan": "pro"
},
"access": {
"limits": {
"instances": 6,
"members": 15
}
},
"usage": {
"instances": 1,
"members": 2
},
"twoFactorEnabled": true
}
}
Respostas de sucesso são envelopadas em data.
Erros comuns
400
Corpo, query ou parâmetro inválido. A resposta traz error.code e error.message.
401
Credencial ausente, inválida ou sessão expirada.
403
Papel insuficiente ou workspace suspenso.