Saltar para o conteúdo principal
POST
Emitir Atestado
Esta é a variante de rota de coleta da cunhagem de atestados. Use a opção de registro estruturado ou payload codificado mostrada em Experimente e mantenha a mesma Idempotency-Key ao repetir a mesma solicitação. Pacotes de verificação e tipos de registro permanecem selecionáveis no esquema da solicitação.

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

Corpo

application/json

Escolha Registro estruturado para selecionar um tipo de registro e inserir reivindicações, ou Payload codificado para assinar bytes existentes. Nunca combine ambos os formatos de entrada.

alg
enum<string>
obrigatório

Deve corresponder à chave de assinatura do emissor selecionada.

Opções disponíveis:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
issuer_id
string<uuid>
obrigatório

O UUID do emissor que cria o atestado

Exemplo:

"550e8400-e29b-41d4-a716-446655440000"

kid
string
obrigatório

Identificador da chave para a chave de assinatura

Exemplo:

"es256-key-1"

schema
enum<string>
obrigatório

Tipo de registro para entrada estruturada. Forneça reivindicações e omita payload_b64url. Este rótulo não valida independentemente a veracidade das reivindicações.

Opções disponíveis:
verifiable-id,
passport,
drivers-license,
government-id,
self-sovereign-id,
employment-verification,
professional-role,
membership-card,
professional-certification,
license,
accreditation,
degree,
completion-cert,
course-credit,
transcript,
micro-credential,
training-completion,
medical-license,
dea-registration,
board-certification,
health-credential,
vaccination-record,
aml-kyc,
security-clearance,
sam-gov,
jurisdiction-approval,
attestation-of-will,
bank-verification,
credit-attestation,
income-verification,
skill-badge,
competency,
industry-cert,
product-authenticity,
chain-of-custody,
origin-verification,
custom,
attestation
Exemplo:

"verifiable-id"

claims
object
obrigatório

Campos de registro estruturados. Obrigatório com esquema; não pode ser combinado com payload_b64url.

Exemplo:
attestation_id
string
content_type
string

Tipo MIME dos bytes originais, como application/json, application/pdf ou image/png. A entrada de esquema/declarações estruturadas requer application/json.

Exemplo:

"application/json"

document_hash
string

Hash SHA-256 hexadecimal opcional do documento. Um claims.document.sha256 incorporado tem precedência; caso contrário, este campo é usado, depois o hash do payload decodificado.

pack_id
string<uuid>

UUID opcional do pacote de verificação do espaço de trabalho. Use Listar pacotes de verificação com a mesma chave de API para selecionar um pacote ativo existente; omita para um registro autônomo.

expires_at_unix
integer<int64>

Timestamp Unix futuro opcional em segundos para entrada de esquema/declarações estruturadas. Ele é incluído no payload JSON assinado. Para entrada payload_b64url, omita este campo de solicitação e incorpore expires_at_unix na raiz do payload JSON exato. A expiração não pode ser alterada no local.

Intervalo necessário: 1 <= x <= 253402300799
recipient_email
string<email>

Destinatário opcional para notificação assíncrona após a cunhagem. Uma resposta de cunhagem bem-sucedida não confirma a entrega.

Resposta

Atestação cunhada

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>