1. Acuñar
Siga el inicio rápido utilizando el emisor y la clave de firma del espacio de trabajo empresarial. Proporcione las reclamaciones de la aplicación a través de la entrada estructuradaschema y claims, o codifique los bytes originales exactos como payload_b64url. No combine ambos modos. Conserve el attestation_id devuelto; no sustituya un identificador att_ inventado donde la API requiere un UUID.
2. Entregar
Use Entregar a la bandeja de entrada conattestation_id, el correo electrónico del destinatario en consumer_reference y safe_metadata opcional. Use una credencial de emisor para el espacio de trabajo propietario de la atestación.
HTTP 201 registra la entrega a una bandeja de entrada de consumidor existente. HTTP 202 con status: pending y reason: consumer_not_registered registra una entrega pendiente. Ninguna de las respuestas prueba que un correo electrónico llegó al destinatario. Evite afirmaciones sensibles en los metadatos de visualización.
3. Leer la bandeja de entrada
El consumidor se autentica por separado y utiliza Inbox.read_state acepta UNREAD, READ, ARCHIVED o ALL. Una clave comercial no debe usarse como identidad del consumidor.
La entrega en la bandeja de entrada y la visibilidad pública del portafolio son separadas. No asuma que un elemento de la bandeja de entrada se compartió públicamente simplemente porque la entrega fue exitosa.
4. Verificar
Use Verificar con el ID de atestación y, opcionalmente, la carga útil codificada original o el hash del documento. Este punto final no acepta un campoproof_bundle base64. Inspeccione el veredicto y las razones en lugar de solo el estado HTTP.
Para pruebas fuera de línea, siga la especificación del paquete de prueba. La validación criptográfica fuera de línea necesita claves públicas confiables y no puede establecer el estado de revocación actual sin información de estado reciente. Ni la verificación de firma en línea ni fuera de línea prueban que la afirmación subyacente del mundo real sea verdadera.
