Saltar al contenido principal
POST
Atestación de acuñación
Esta es la variante de ruta de colección de la acuñación de atestaciones. Utilice la opción de registro estructurado o carga útil codificada que se muestra en Probar y conserve la misma clave de idempotencia al reintentar la misma solicitud. Los paquetes de verificación y los tipos de registro siguen siendo seleccionables en el esquema de solicitud.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Encabezados

Idempotency-Key
string
requerido

Cuerpo

application/json

Elija Registro estructurado para seleccionar un tipo de registro e ingresar reclamaciones, o Carga útil codificada para firmar bytes existentes. Nunca combine ambos formatos de entrada.

alg
enum<string>
requerido

Debe coincidir con la clave de firma del emisor seleccionada.

Opciones disponibles:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
issuer_id
string<uuid>
requerido

El UUID del emisor que crea la atestación

Ejemplo:

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

kid
string
requerido

Identificador de clave para la clave de firma

Ejemplo:

"es256-key-1"

schema
enum<string>
requerido

Tipo de registro para entrada estructurada. Proporcione reclamaciones y omita payload_b64url. Esta etiqueta no valida de forma independiente la veracidad de las reclamaciones.

Opciones disponibles:
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
Ejemplo:

"verifiable-id"

claims
object
requerido

Campos de registro estructurados. Requerido con esquema; no se puede combinar con payload_b64url.

Ejemplo:
attestation_id
string
content_type
string

Tipo MIME de los bytes originales, como application/json, application/pdf o image/png. La entrada de esquema/declaraciones estructuradas requiere application/json.

Ejemplo:

"application/json"

document_hash
string

Hash SHA-256 hexadecimal opcional del documento. Un claims.document.sha256 incrustado tiene prioridad; de lo contrario, se utiliza este campo, luego el hash de la carga decodificada.

pack_id
string<uuid>

UUID opcional del paquete de verificación del espacio de trabajo. Utilice List verification packs con la misma clave API para seleccionar un paquete activo existente; omítalo para un registro independiente.

expires_at_unix
integer<int64>

Marca de tiempo Unix futura opcional en segundos para la entrada de esquema/reclamaciones estructuradas. Se incluye en la carga JSON firmada. Para la entrada payload_b64url, omita este campo de solicitud e incruste expires_at_unix en la raíz de la carga JSON exacta. La caducidad no se puede cambiar en su lugar.

Rango requerido: 1 <= x <= 253402300799
recipient_email
string<email>

Destinatario opcional para notificación asíncrona después de la acuñación. Una respuesta de acuñación exitosa no confirma la entrega.

Respuesta

Atestación acuñada

id
string<uuid>
issuer_id
string<uuid>
kid
string
status
enum<string>
Opciones disponibles:
VALID,
REVOKED,
SUPERSEDED
payload
object
signature
string
log_index
integer
created_at
string<date-time>