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

# Integrationsbeispiele

> Ein direktes HTTP-Mint-Beispiel mit expliziter Kodierung und Idempotenz.

Dieses Beispiel verwendet das integrierte `fetch` von Node.js, um den HTTP-Vertrag explizit zu machen. Es hängt nicht von einer SDK-Version ab. SDK-Versionen können unterschiedliche Modelle und Authentifizierungsoptionen haben; überprüfen Sie die installierte Version, bevor Sie Beispiele anpassen.

## Voraussetzungen

Verwenden Sie einen API-Schlüssel, einen Aussteller und einen verfügbaren verwalteten Signierschlüssel aus derselben Umgebung. Die Registrierung eines öffentlichen Schlüssels allein stellt keinen privaten Signierschlüssel bereit. Schließen Sie zuerst die [Arbeitsbereichseinrichtung](https://docs.truthlocks.com/de/quickstart.md) ab.

## Prägen mit Node.js

Speichern Sie als `mint.mjs`. Konfigurieren Sie die unten stehenden Umgebungsvariablen über Ihre Shell oder Ihren Secret Manager und führen Sie dann `node mint.mjs` mit einer Node.js-Version aus, die `fetch` unterstützt.

```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 });
```

Behalten Sie den ursprünglichen Body und den Idempotenzschlüssel bei, wenn Sie nach einem Timeout erneut versuchen. Dieses kurze Beispiel implementiert keine persistenten Jobs oder automatischen Wiederholungen. Vermeiden Sie das Protokollieren von API-Schlüsseln, privaten Nutzlasten oder Rohantworten, die persönliche Daten enthalten.

## Ergebnisse verifizieren und interpretieren

Übermitteln Sie die zurückgegebene ID an [Verify](https://docs.truthlocks.com/de/api-reference/verify.md). Fügen Sie die ursprüngliche `payload_b64url` hinzu, wenn Sie die genauen Bytes überprüfen möchten. Überprüfen Sie `verdict` und `reasons`; HTTP 200 allein begründet keine Gültigkeit.

Die Signatur beweist eine kryptografische Beziehung zum Signaturschlüssel. Sie verifiziert nicht unabhängig die reale Wahrheit der eingereichten Behauptungen.

Für die Standardbibliotheksversion von Python siehe den [Quickstart](https://docs.truthlocks.com/de/quickstart.md). Für den Widerruf und Ersatz folgen Sie den generierten Anforderungsverträgen für [revoke](https://docs.truthlocks.com/de/api-reference/attestations/revoke.md) und [supersede](https://docs.truthlocks.com/de/api-reference/attestations/supersede.md); verwenden Sie keinen Mint-Body für diese Operationen.


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