Verificar token

Verifique um JWT do Clowk e obtenha o usuário logado com POST /api/v1/tokens/verify, e veja as claims do JWT, assinado em HS256 com sua secret key.

POST /api/v1/tokens/verify

Verifica um JWT do Clowk e retorna o usuário ligado a ele. O token deve pertencer à mesma instância da secret key usada na autenticação.

Requisição

curl -X POST https://myapp.clowk.dev/api/v1/tokens/verify \
  -H "Content-Type: application/json" \
  -H "X-Clowk-Secret-Key: sk_live_..." \
  -d '{ "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }'

Headers

HeaderObrigatórioDescrição
X-Clowk-Secret-KeySimA secret key da sua instância
Content-TypeSimapplication/json

Body

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
CampoTipoObrigatórioDescrição
tokenstringSimO JWT a verificar

Resposta

200 — Token válido

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "resource": "token",
  "data": {
    "valid": true,
    "email": "[email protected]",
    "name": "Jane Doe",
    "avatar_url": "https://lh3.googleusercontent.com/...",
    "provider": "google"
  }
}

400 — Token ausente

{
  "error": "Missing token"
}

401 — Token inválido

{
  "valid": false,
  "error": "Token invalid signature"
}

Também retorna 401 se o token pertence a outra instância:

{
  "valid": false,
  "error": "Token does not belong to this instance"
}

404 — Usuário não encontrado

{
  "error": "User not found"
}

Estrutura do payload do JWT

Quando você decodifica um JWT do Clowk, o payload contém:

{
  "iss": "clowk",
  "iat": 1711152000,
  "exp": 1711155600,
  "sub": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "email": "[email protected]",
  "name": "Jane Doe",
  "avatar_url": "https://lh3.googleusercontent.com/...",
  "provider": "google",
  "instance_id": "inst_abc123",
  "app_id": "app_xyz789"
}
ClaimDescrição
issSempre "clowk"
subID do usuário (UUID)
emailEndereço de email do usuário
nameNome de exibição do usuário
avatar_urlURL da foto de perfil vinda do provedor OAuth
providerProvedor de autenticação (google, github, twitter, email)
instance_idO ID da sua instância no Clowk
app_idO ID do seu app no Clowk
iatEmitido em (timestamp Unix)
expExpira em (timestamp Unix, 1 hora depois de iat)

Os tokens são assinados com HS256 usando a secret key da sua instância.

Nesta página