> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Paquete de Integración Técnica

> Guía de inicio rápido y estrategia API para desarrolladores

**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`.

```json theme={null}
{
  "template_key": "academic_transcript",
  "payload": {
    "student_id": "STU123",
    "gpa": "3.8"
  },
  "recipient_email": "student@university.edu"
}
```

## 3. Webhooks y Eventos

Truthlocks utiliza webhooks para notificar a su sistema sobre cambios de estado.

| Tipo de evento | Descripción |
| :- | :- |
| `attestation.created` | Se activa cuando la plataforma ha firmado el registro. |
| `issuer.suspended` | Se activa si cambia la calificación de confianza del emisor. |
| `billing.usage.threshold` | Se activa cuando se alcanza un umbral de uso. |

**Verificación**: Siempre verifique el encabezado `X-Truthlocks-Signature` usando el secreto compartido de su endpoint. Consulte la [guía de webhooks](https://docs.truthlocks.com/es/guides/webhooks.md) 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.

> [!TIP]
>
> Utilice nuestros [SDK](https://docs.truthlocks.com/es/sdk/js.md) para gestionar reintentos, verificación de firmas y
> la serialización de la carga útil automáticamente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.