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

# Schnellstart

> Prägen und verifizieren Sie einen Datensatz mit Ihrem Arbeitsbereichs-Aussteller und Signaturschlüssel.

Eine Bestätigung signiert eine Nutzlast und zeichnet ihren Hash auf. Die Verifizierung prüft die kryptografische Integrität und den Aufzeichnungsstatus; sie stellt nicht unabhängig fest, dass die Behauptungen des Ausstellers wahr sind.

## Bevor Sie beginnen

Wählen Sie in [Console](https://console.truthlocks.com) Ihren Arbeitsbereich und Ihre Umgebung aus. Besorgen Sie sich einen API-Schlüssel, eine Aussteller-ID und einen aktiven Schlüssel, der für die serverseitige Signierung verfügbar ist. Verwenden Sie den für diesen Schlüssel angezeigten Algorithmus. Die alleinige Registrierung eines öffentlichen Schlüssels gibt dem Signaturdienst nicht seinen privaten Schlüssel.

Verwenden Sie `https://sandbox-api.truthlocks.com` mit einem Sandbox-Schlüssel (`tl_test_`). Verwenden Sie `https://api.truthlocks.com` mit einem Produktionsschlüssel (`tl_live_`) und einem genehmigten Arbeitsbereich. Ressourcen und Anmeldeinformationen müssen zur selben Umgebung gehören. Senden Sie `X-Tenant-ID` nicht, um einen Arbeitsbereich auszuwählen: Er wird von Ihren Anmeldeinformationen abgeleitet.

## Einen Datensatz prägen

Dieses Beispiel verwendet die Standardbibliothek von Python 3. Legen Sie die vier erforderlichen Umgebungsvariablen über Ihre Shell oder Ihren Secret Manager fest. Setzen Sie `TRUTHLOCKS_BASE_URL` nur, wenn Sie von Sandbox auf Produktion umstellen.

```python theme={null}
import base64
import json
import os
import urllib.request
import uuid

base_url = os.environ.get("TRUTHLOCKS_BASE_URL", "https://sandbox-api.truthlocks.com").rstrip("/")
payload = json.dumps({"subject": "demo-record", "message": "Example issuer claim"},
                     separators=(",", ":")).encode("utf-8")
body = {
    "issuer_id": os.environ["TRUTHLOCKS_ISSUER_ID"],
    "kid": os.environ["TRUTHLOCKS_KEY_ID"],
    "alg": os.environ["TRUTHLOCKS_ALGORITHM"],
    "content_type": "application/json",
    "payload_b64url": base64.urlsafe_b64encode(payload).decode("ascii").rstrip("="),
}
# Retain this value and the same body if retrying this mint request.
idempotency_key = str(uuid.uuid4())
request = urllib.request.Request(
    base_url + "/v1/attestations/mint",
    data=json.dumps(body).encode("utf-8"),
    headers={"Content-Type": "application/json",
             "X-API-Key": os.environ["TRUTHLOCKS_API_KEY"],
             "Idempotency-Key": idempotency_key},
    method="POST",
)
with urllib.request.urlopen(request, timeout=30) as response:
    record = json.load(response)
print("Attestation ID:", record["attestation_id"])
print("Recorded at (Unix seconds):", record["issued_at_unix"])
```

HTTP-Fehler lösen `urllib.error.HTTPError` aus. Behandeln Sie Fehler und Timeouts in Ihrer Anwendung; bewahren Sie denselben Idempotenzschlüssel und -text auf, wenn Sie ein unsicheres Prägeergebnis erneut versuchen.

Die Antwort verwendet `attestation_id`, `issued_at_unix`, `signature` und `log`. Sie gibt die Claims nicht als Top-Level-`payload` wieder. Behalten Sie die Original-Bytes für nachfolgende Integritätsprüfungen bei.

## Ergebnis verifizieren

Verwenden Sie die [Verifizierungsreferenz](https://docs.truthlocks.com/de/api-reference/verify.md) mit dem zurückgegebenen `attestation_id`. Geben Sie `payload_b64url` an, um die genauen Original-Bytes zu überprüfen, oder `document_hash_hex`, um einen Dateihash zu vergleichen. Überprüfen Sie `verdict` und `reasons`: eine erfolgreiche HTTP-Antwort allein bedeutet nicht, dass der Datensatz gültig ist.

## Fehlerbehebung

* **401 oder 403:** Überprüfen Sie Anmeldeinformationen, Umgebung, Berechtigungen und die Genehmigung des Arbeitsbereichs.
* **400:** Überprüfen Sie UUIDs, den Idempotenz-Header und die ungepolsterte base64url-Kodierung.
* **Schlüssel- oder Richtlinienfehler:** Bestätigen Sie, dass der Aussteller und der Schlüssel zum Signieren verwendet werden können und der Algorithmus übereinstimmt.
* **Timeout:** Wiederholen Sie den Vorgang mit dem ursprünglichen Body und dem Idempotenzschlüssel, anstatt eine neue Prägung zu erstellen.

Fahren Sie fort mit [Mint-Parametern](https://docs.truthlocks.com/de/api-reference/attestations/mint.md), [Authentifizierung](https://docs.truthlocks.com/de/security/auth.md) und [Umgebungen](https://docs.truthlocks.com/de/environments.md).


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