vértice
Produto Preços Painel
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=..."
GET /auth/me
Sessão do painel
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

Resposta

200
{
  "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.