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

# SDK JavaScript / TypeScript

Installez le package public:

```bash theme={null}
npm install @truthlocks/sdk@^2.1.0
```

Utilisez Node.js 18 ou une version ultérieure. Les ressources principales sont `issuers`, `keys`, `attestations`, `verify`, `audit` et `receipts`. Ne supposez pas que chaque API publique dispose d'une méthode de commodité dans ce package ; utilisez la référence d'opération et `client.request` le cas échéant.

## Configurer l'authentification

```typescript theme={null}
import { TruthlockClient } from '@truthlocks/sdk';

const apiKey = process.env.TRUTHLOCKS_API_KEY;
if (!apiKey) throw new Error('Set TRUTHLOCKS_API_KEY');
const client = new TruthlockClient({
  baseUrl: 'https://sandbox-api.truthlocks.com',
  auth: { type: 'service', apiKey },
});
```

La stratégie de clé API est `service`, pas `apiKey`. Pour une opération utilisateur, utilisez `auth: { type: 'bearer', token }` avec un jeton utilisateur valide. `tenantId` n'authentifie pas et ne change pas d'espace de travail. N'utilisez pas l'authentification réservée aux locataires.

## Mint

Utilisez un émetteur existant et une clé disponible pour la signature côté serveur. Utilisez soit les octets originaux encodés, soit les entrées structurées `schema` et `claims`.

```typescript theme={null}
const payload = Buffer.from(JSON.stringify({ subject: 'demo-record' }), 'utf8');
const record = await client.attestations.mint({
  issuer_id: process.env.TRUTHLOCKS_ISSUER_ID!,
  kid: process.env.TRUTHLOCKS_KEY_ID!,
  alg: process.env.TRUTHLOCKS_ALGORITHM!,
  payload_b64url: payload.toString('base64url'),
});
console.log(record.attestation_id);
```

Définissez les trois variables d'environnement avant d'exécuter l'extrait. Pour une entrée structurée, remplacez `payload_b64url` par `schema: "attestation"` et `claims: { subject: "demo-record" }` ; n'envoyez jamais les deux modes. L'enregistrement de la clé publique seule ne provisionne pas de clé privée de signature.

## Nouvelles tentatives et gestion des réponses

Le client ajoute un en-tête d'idempotence aux requêtes POST et PUT. Un nouvel appel de méthode génère une nouvelle clé, ce n'est donc pas une nouvelle tentative sûre d'une écriture antérieure incertaine, sauf si vous conservez et transmettez la même clé. `client.request` accepte une option `idempotencyKey`. Les nouvelles tentatives automatiques sont limitées aux lectures et aux écritures d'attestation/réception prises en charge avec une clé explicite ; les écritures arbitraires ne sont pas rejouées simplement parce qu'une clé a été fournie.

Inspectez la vérification `verdict` et `reasons`. Une promesse résolue ou un code HTTP 200 seul ne constitue pas un résultat de vérification valide. Faites correspondre la version du package installé avec ses déclarations de type ; une source nouvellement corrigée ne prouve pas qu'une version plus ancienne installée contient les correctifs.

Consultez l'[exemple HTTP direct](https://docs.truthlocks.com/fr/guides/sdk-examples.md) pour une intégration indépendante des dépendances et la [référence API](https://docs.truthlocks.com/fr/api-reference/attestations/mint.md) pour le contrat actuel.


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