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

# Python SDK

Installieren Sie die Distribution, deren Quellpaket `truthlock` ist:

```bash theme={null}
python -m pip install "truthlock>=0.4.0"
```

Der Import ist `from truthlock import TruthlockClient`. Paketnamen für MAIP-Integrationen sind separate Distributionen und implizieren nicht dieselbe API.

## Prägen mit einem vorhandenen Signierschlüssel

```python theme={null}
import base64
import json
import os
from truthlock import TruthlockClient

payload = json.dumps({"subject": "demo-record"}, separators=(",", ":")).encode("utf-8")
with TruthlockClient(
    api_key=os.environ["TRUTHLOCKS_API_KEY"],
    base_url="https://sandbox-api.truthlocks.com",
) as client:
    record = client.attestations.mint(
        issuer_id=os.environ["TRUTHLOCKS_ISSUER_ID"],
        kid=os.environ["TRUTHLOCKS_KEY_ID"],
        alg=os.environ["TRUTHLOCKS_ALGORITHM"],
        payload_b64url=base64.urlsafe_b64encode(payload).decode("ascii").rstrip("="),
    )
    print(record.attestation_id)
```

Legen Sie zuerst die vier Umgebungsvariablen fest. Verwenden Sie einen Sandbox-Schlüssel, einen Aussteller und einen Schlüssel, der in dieser Umgebung zum Signieren verfügbar ist. Die Registrierung eines öffentlichen Schlüssels stellt keinen privaten Signaturschlüssel bereit.

## Verifizieren

Rufen Sie `client.verify.verify_online(attestation_id=record.attestation_id)` auf und überprüfen Sie das Ergebnis. Fügen Sie `payload_b64url` hinzu, wenn Sie die ursprünglichen Bytes überprüfen. Das Backend verwendet großgeschriebene Wire-Ergebnisse; das korrigierte SDK normalisiert sie auf seine kleingeschriebenen Enum-Werte. Version 0.4.0 und höher enthalten die korrigierte Ergebnis-Parsierung.

## Versions- und Wiederholungsgrenzen

Die implementierten Kernressourcengruppen sind `issuers`, `keys`, `attestations`, `verify` und `receipts`. Rufen Sie keine hypothetischen `consumer`, `governance` oder `audit` Ressourcenmethoden auf diesem Client auf.

Das Prägen erzeugt einen Idempotenz-Header. Das Wiederholen derselben internen Anfrage kann diesen beibehalten, aber ein erneuter Aufruf von mint erzeugt einen neuen Vorgang, es sei denn, derselbe Schlüssel wird bereitgestellt. Bewahren Sie Schlüssel und Anforderungs-Bodies in dauerhaften Anwendungsaufträgen auf. Ein Timeout beweist nicht, dass ein Schreibvorgang fehlgeschlagen ist.

Verwenden Sie den [HTTP-Schnellstart](https://docs.truthlocks.com/de/quickstart.md), um eine Veröffentlichung mit dem tatsächlichen Wire-Vertrag zu vergleichen. Installieren Sie Version 0.4.0 oder höher, um die korrigierten Transport- und Proof-Bundle-Felder zu verwenden.


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