Saltar al contenido principal
Guía de inicio rápido y estrategia de API para desarrolladores

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:
  1. Datos originales: La carga útil que acuñó.
  2. Firma del emisor: Su prueba criptográfica de intención.
  3. 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.
Utilice nuestros SDK para gestionar reintentos, verificación de firmas y la serialización de la carga útil automáticamente.