Saltar para o conteúdo principal
POST
Emitir recibo
Cria um evento de recibo criptograficamente assinado e ancorado no log de transparência. Os recibos são validados em relação ao esquema de tipo de recibo registrado antes da assinatura.

Tipos de recibo

Cabeçalhos

Resposta

string
UUID do recibo criado.
string
O nome do tipo de recibo.
string
active
string
UUID do emissor assinante.
string
Identificador do assunto.
object
Assinatura criptográfica: alg, kid, value.
string
Timestamp ISO 8601.

Evento de webhook

Um evento de webhook receipt.created é entregue a todos os endpoints configurados após uma cunhagem bem-sucedida.

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

UUID para cunhagem idempotente

Corpo

application/json
issuer_id
string
obrigatório

UUID do emissor que assina o recibo

kid
string
obrigatório

ID da chave de assinatura

payload
any
obrigatório

Carga útil do recibo validada contra o esquema

receipt_type
string
obrigatório

Nome do tipo de recibo

subject
string
obrigatório

Identificador do assunto

alg
enum<string>

Algoritmo de assinatura correspondente à chave.

Opções disponíveis:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
metadata
any

Metadados opcionais

receipt_version
string
retention_policy
string

Resposta

Recibo criado

receipt_id
string
receipt_type
string
status
string
issuer_id
string
subject
string
signature
object
issued_at
string