Saltar para o conteúdo principal
POST
Substituir Atestado
Cria uma nova atestação que substitui uma existente. A atestação original é marcada como SUPERSEDED com uma referência à nova versão. A nova atestação é assinada com a chave especificada, registrada no log de transparência e retornada junto com a original atualizada. Ambas as atestações permanecem verificáveis, criando uma cadeia auditável de versões de credenciais. Apenas atestações VALID podem ser substituídas — atestações REVOKED ou já SUPERSEDED retornam um 409 Conflict.

Como funciona

1

Chamar substituição com o ID de atestação original

Forneça o UUID da atestação a ser substituída como um parâmetro de caminho, juntamente com o novo payload e a chave de assinatura.
2

Atestado original marcado como SUBSTITUÍDO

O status do atestado original muda para SUPERSEDED com um carimbo de data/hora e uma referência ao novo ID do atestado.
3

Novo atestado criado com status VÁLIDO

Uma nova atestação é cunhada com o payload atualizado, assinada com a chave especificada e registrada no log de transparência.
4

Ambos retornados na resposta

A resposta inclui os objetos de atestado antigo (substituído) e novo (válido) sob as chaves old e new.

Casos de uso comuns

Respostas

As operações de substituição são idempotentes ao usar o mesmo Idempotency-Key. Tentar novamente uma solicitação falha com a mesma chave é seguro e não criará atestações duplicadas.
A atestação original permanece no log de transparência e ainda pode ser verificada. Seu status muda para SUPERSEDED, mas a prova criptográfica é preservada. Os verificadores podem rastrear a cadeia de supersessão completa seguindo o campo superseded_by_attestation_id.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Cabeçalhos

Idempotency-Key
string
obrigatório

Parâmetros de caminho

id
string<uuid>
obrigatório

Corpo

application/json
alg
string
obrigatório
kid
string
obrigatório
payload_b64url
string
obrigatório

Resposta

201 - application/json

Novo atestado criado

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
Opções disponíveis:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>