> ## 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.

# Ejemplos de integración

> Un ejemplo de acuñación HTTP directa con codificación explícita e idempotencia.

Este ejemplo utiliza el `fetch` incorporado de Node.js para hacer explícito el contrato HTTP. No depende de una versión del SDK. Las versiones del SDK pueden tener diferentes modelos y opciones de autenticación; verifique la versión instalada antes de adaptar los ejemplos.

## Requisitos previos

Utilice una clave de API, un emisor y una clave de firma gestionada disponible del mismo entorno. El registro de clave pública por sí solo no proporciona una clave de firma privada. Complete primero la [configuración del espacio de trabajo](https://docs.truthlocks.com/es/quickstart.md).

## Acuñar con Node.js

Guarde como `mint.mjs`. Configure las variables de entorno a continuación a través de su shell o administrador de secretos, luego ejecute `node mint.mjs` con una versión de Node.js que admita `fetch`.

```javascript theme={null}
import { randomUUID } from 'node:crypto';

const required = name => {
  const value = process.env[name];
  if (!value) throw new Error(`Set ${name}`);
  return value;
};
const baseUrl = (process.env.TRUTHLOCKS_BASE_URL ??
  'https://sandbox-api.truthlocks.com').replace(/\/$/, '');
const payload = Buffer.from(JSON.stringify({
  subject: 'demo-record', message: 'Example issuer claim'
}), 'utf8');
const body = {
  issuer_id: required('TRUTHLOCKS_ISSUER_ID'),
  kid: required('TRUTHLOCKS_KEY_ID'),
  alg: required('TRUTHLOCKS_ALGORITHM'),
  content_type: 'application/json',
  payload_b64url: payload.toString('base64url'),
};
// Persist this value with the body before issuing requests in a durable job.
const idempotencyKey = randomUUID();
const response = await fetch(`${baseUrl}/v1/attestations/mint`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': required('TRUTHLOCKS_API_KEY'),
    'Idempotency-Key': idempotencyKey,
  },
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`Mint failed: HTTP ${response.status}`);
const record = await response.json();
console.log({ attestationId: record.attestation_id, recordedAt: record.issued_at_unix });
```

Conserve el cuerpo original y la clave de idempotencia al reintentar después de un tiempo de espera. Este breve ejemplo no implementa trabajos persistentes ni reintentos automáticos. Evite registrar claves API, cargas útiles privadas o respuestas sin procesar que contengan datos personales.

## Verificar e interpretar resultados

Envíe el ID devuelto a [Verify](https://docs.truthlocks.com/es/api-reference/verify.md). Agregue el `payload_b64url` original si desea verificar los bytes exactos. Inspeccione `verdict` y `reasons`; HTTP 200 por sí solo no establece la validez.

La firma prueba una relación criptográfica con la clave de firma. No verifica de forma independiente la verdad real de las afirmaciones enviadas.

Para la versión de la biblioteca estándar de Python, consulte el [inicio rápido](https://docs.truthlocks.com/es/quickstart.md). Para la revocación y el reemplazo, siga los contratos de solicitud generados para [revocar](https://docs.truthlocks.com/es/api-reference/attestations/revoke.md) y [sustituir](https://docs.truthlocks.com/es/api-reference/attestations/supersede.md); no reutilice un cuerpo de acuñación para esas operaciones.


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