1. Autenticación
Todas las solicitudes de API deben autenticarse mediante tokens Bearer.- Claves API: Emitidas a través del Inquilino Console (Seguridad > Claves API).
- Alcances: Las claves están limitadas a acciones específicas (por ejemplo,
mint,verify,read_audit). - Rotación: Recomendamos una política de rotación de 90 días. Invalide las claves inmediatamente a través del endpoint DELETE en caso de compromiso.
2. El Flujo de Acuñación
Para emitir una atestación, POST una carga útil JSON a/v1/attestations/mint.
3. Webhooks y Eventos
Truthlocks utiliza webhooks para notificar a su sistema sobre cambios de estado.
Verificación: Siempre verifique el encabezado
X-Truthlocks-Signature usando el secreto compartido de su endpoint. Consulte la guía de webhooks para obtener detalles completos sobre los tipos de eventos, la verificación de firmas y el comportamiento de reintentos.
4. Paquetes de Prueba
Un Paquete de Prueba es un objeto JSON firmado que contiene:- Datos originales: La carga útil que acuñó.
- Firma del emisor: Su prueba criptográfica de intención.
- Punto de control de la plataforma: Prueba de Truthlocks del estado de la red en el momento de la acuñación.
5. Límites de Tasa y Cuotas
Los límites se aplican por inquilino según su nivel de suscripción:- Ráfaga global: 500 solicitudes cada 10 segundos.
- Cuota de Acuñación Mensual: Definida en su Acuerdo Empresarial (visible en
/v1/billing/usage).
6. Separación de Entornos
Ofrecemos dos entornos distintos:- Sandbox (
sandbox.truthlocks.com): Para pruebas con claves simuladas y datos efímeros. - Producción (
api.truthlocks.com): Federada para emisión de alto riesgo.

