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

# Exemples d'intégration

> Un exemple de frappe HTTP directe avec encodage explicite et idempotence.

Cet exemple utilise le `fetch` intégré de Node.js pour rendre le contrat HTTP explicite. Il ne dépend pas d'une version du SDK. Les versions du SDK peuvent avoir des modèles et des options d'authentification différents ; vérifiez la version installée avant d'adapter les exemples.

## Prérequis

Utilisez une clé API, un émetteur et une clé de signature gérée disponible du même environnement. L'enregistrement de la clé publique seule ne provisionne pas de clé de signature privée. Complétez d'[installation de l'espace de travail](https://docs.truthlocks.com/fr/quickstart.md) d'abord.

## Créer avec Node.js

Enregistrez sous `mint.mjs`. Configurez les variables d'environnement ci-dessous via votre shell ou votre gestionnaire de secrets, puis exécutez `node mint.mjs` avec une version de Node.js prenant en charge `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 });
```

Conservez le corps original et la clé d'idempotence lors de la nouvelle tentative après un délai d'attente. Ce court exemple n'implémente pas de tâches persistantes ni de nouvelles tentatives automatiques. Évitez de journaliser les clés API, les charges utiles privées ou les réponses brutes contenant des données personnelles.

## Vérifier et interpréter les résultats

Soumettez l'ID retourné à [Verify](https://docs.truthlocks.com/fr/api-reference/verify.md). Ajoutez l'`payload_b64url` original si vous souhaitez vérifier les octets exacts. Inspectez `verdict` et `reasons` ; HTTP 200 seul n'établit pas la validité.

La signature prouve une relation cryptographique avec la clé de signature. Elle ne vérifie pas indépendamment la vérité factuelle des revendications soumises.

Pour la version de la bibliothèque standard de Python, consultez le [guide de démarrage rapide](https://docs.truthlocks.com/fr/quickstart.md). Pour la révocation et le remplacement, suivez les contrats de demande générés pour [révoquer](https://docs.truthlocks.com/fr/api-reference/attestations/revoke.md) et [remplacer](https://docs.truthlocks.com/fr/api-reference/attestations/supersede.md) ; ne réutilisez pas un corps de frappe pour ces opérations.


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