Una atestación es una declaración firmada de un emisor. Una integración útil gestiona todo el ciclo de vida: qué se firma, cómo lo verifican los destinatarios, cómo se comparte la evidencia y qué sucede cuando ya no se debe confiar en la declaración.
Defina el registro antes de llamar a la API
Elija una referencia comercial estable, el emisor responsable de la declaración y la carga útil mínima requerida para el flujo de trabajo. Utilice el esquema compatible y la codificación exacta documentada para su versión de API. No improvise formatos de firma a partir de un certificado visual o un ejemplo de código antiguo.
Para un registro de finalización de curso, los campos importantes podrían incluir una referencia del curso y los detalles de finalización aprobados. La institución decide qué significa la declaración. Truthlocks firma y gestiona el registro dentro del flujo de trabajo de emisión configurado.
Emitir y retener el resultado
Utilice la identidad de emisión correcta y la clave de firma configurada. Almacene el identificador de registro devuelto y la evidencia que su aplicación necesita para verificaciones posteriores. Maneje explícitamente los errores de validación, permiso y servicio. Si una solicitud de emisión agota el tiempo de espera, determine si se creó un registro antes de reintentar una escritura.
Verifique el comportamiento de idempotencia real del punto final y la versión del SDK que utiliza. Un límite de reintentos por sí solo no establece que la repetición de una escritura no pueda crear eventos comerciales duplicados.
Verifique antes de presentar una conclusión
Verifique el registro admitido utilizando la información de clave pública adecuada. Mantenga la integridad de la firma, el contexto del emisor y el estado actual visibles como partes separadas del resultado. Si la verificación no está disponible, indíquelo y ofrezca al usuario una ruta de reintento o revisión en lugar de mostrar una insignia de éxito.
Compartir y gestionar cambios
Un enlace de verificación ofrece a los destinatarios una ruta a la verificación actual. Un paquete de prueba puede llevar firmas, claves y pruebas de registro disponibles para inspección independiente. La evidencia fuera de línea no puede informar una revocación que ocurrió después de la creación del paquete.
Defina quién puede revocar un registro y cuándo una declaración corregida requiere una nueva emisión. Pruebe un registro revocado y una carga útil modificada antes de integrar la ruta de éxito en su interfaz de usuario.
Construya con la documentación actual
Utilice el documentación actual de la API y las firmas de métodos de su SDK instalado. Comience con el ejemplo de finalización de curso o flujo de trabajo de registro de permisos, luego adapte los campos y las responsabilidades de aprobación a su sistema.
