API atual/Referência completa/Autenticação avançada

Listar e remover passkeys

Mostra as passkeys cadastradas pelo usuário logado e remove uma delas.

Use estas duas rotas na tela de segurança da conta: o cliente vê em quais aparelhos tem passkey e remove a de um aparelho perdido ou vendido. Elas só enxergam as passkeys do próprio usuário do token; não há como listar ou apagar as de outra pessoa.

GET/api/v1/auth/webauthn/credentialsAutenticada

Listar as passkeys do usuário

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/auth/webauthn/credentials" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Passkeys do usuário

json

{
  "credentials": [
    {
      "id": "9d3b5c10-2f7e-4a38-8d51-0c7e6b1a2f44",
      "nickname": "iPhone da Maria",
      "rp_id": "minhaloja.io.venddor.com.br",
      "last_used_at": null,
      "created_at": "2026-10-11T20:41:07Z"
    }
  ]
}

Campos da resposta

credentialsarray

Passkeys cadastradas, vazio se não há nenhuma.

credentials[].iduuid

Id da passkey na plataforma.

credentials[].nicknamestring

Apelido dado no cadastro.

credentials[].rp_idstring

Domínio da loja ao qual a passkey está presa.

credentials[].last_used_atstring

Último login ou confirmação com ela (RFC 3339), ou null.

credentials[].created_atstring

Data de cadastro (RFC 3339, UTC).

DELETE/api/v1/auth/webauthn/credentials/{id}Autenticada

Remover uma passkey

Parâmetros de caminho

iduuidobrigatório

credentials[].id da lista.

bash

curl -X DELETE "$BASE_URL/api/v1/auth/webauthn/credentials/$CREDENTIAL_ID" \
  -H "Authorization: Bearer $TOKEN"

200Passkey removida

json

{
  "message": "passkey removed"
}

Erros

Status	Quando	Exemplo de corpo
401	Sem token de acesso, ou token inválido.	`{"error":"authentication required"}`
404	Passkey inexistente ou de outro usuário.	`{"error":"passkey not found","detail":"..."}`
429	Limite de requisições da família `/auth/`.	`{"error":"rate limit exceeded","detail":"too many requests, please try again later"}`
500	Falha ao listar.	`{"error":"failed to list passkeys","detail":"..."}`

Veja também

Listar e remover passkeys

Mostra as passkeys cadastradas pelo usuário logado e remove uma delas.

GET/api/v1/auth/webauthn/credentialsAutenticada

Listar as passkeys do usuário

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/auth/webauthn/credentials" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Passkeys do usuário

json

{
  "credentials": [
    {
      "id": "9d3b5c10-2f7e-4a38-8d51-0c7e6b1a2f44",
      "nickname": "iPhone da Maria",
      "rp_id": "minhaloja.io.venddor.com.br",
      "last_used_at": null,
      "created_at": "2026-10-11T20:41:07Z"
    }
  ]
}

Campos da resposta

credentialsarray

Passkeys cadastradas, vazio se não há nenhuma.

credentials[].iduuid

Id da passkey na plataforma.

credentials[].nicknamestring

Apelido dado no cadastro.

credentials[].rp_idstring

Domínio da loja ao qual a passkey está presa.

credentials[].last_used_atstring

Último login ou confirmação com ela (RFC 3339), ou null.

credentials[].created_atstring

Data de cadastro (RFC 3339, UTC).

DELETE/api/v1/auth/webauthn/credentials/{id}Autenticada

Remover uma passkey

Parâmetros de caminho

iduuidobrigatório

credentials[].id da lista.

bash

curl -X DELETE "$BASE_URL/api/v1/auth/webauthn/credentials/$CREDENTIAL_ID" \
  -H "Authorization: Bearer $TOKEN"

200Passkey removida

json

{
  "message": "passkey removed"
}

Erros

Status	Quando	Exemplo de corpo
401	Sem token de acesso, ou token inválido.	`{"error":"authentication required"}`
404	Passkey inexistente ou de outro usuário.	`{"error":"passkey not found","detail":"..."}`
429	Limite de requisições da família `/auth/`.	`{"error":"rate limit exceeded","detail":"too many requests, please try again later"}`
500	Falha ao listar.	`{"error":"failed to list passkeys","detail":"..."}`