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

# Technisches Integrationspaket

> Entwickler-Schnellstart & API-Strategie

**Quickstart & API-Strategie für Entwickler**

## 1. Authentifizierung

Alle API-Anfragen müssen über Bearer-Tokens authentifiziert werden.

* **API-Schlüssel**: Ausgabe über die Tenant Console (Sicherheit > API-Schlüssel).
* **Bereiche**: Schlüssel sind auf bestimmte Aktionen beschränkt (z. B. `mint`, `verify`, `read_audit`).
* **Rotation**: Wir empfehlen eine 90-Tage-Rotationsrichtlinie. Ungültige Schlüssel sofort über den DELETE-Endpunkt bei Kompromittierung.

## 2. Der Prägefluss

Um eine Bestätigung auszustellen, POSTen Sie eine JSON-Nutzlast an `/v1/attestations/mint`.

```json theme={null}
{
  "template_key": "academic_transcript",
  "payload": {
    "student_id": "STU123",
    "gpa": "3.8"
  },
  "recipient_email": "student@university.edu"
}
```

## 3. Webhooks & Eventing

Truthlocks verwendet Webhooks, um Ihr System über Zustandsänderungen zu informieren.

| Ereignistyp | Beschreibung |
| :- | :- |
| `attestation.created` | Wird ausgelöst, wenn die Plattform den Datensatz signiert hat. |
| `issuer.suspended` | Wird ausgelöst, wenn sich die Vertrauensbewertung des Ausstellers ändert. |
| `billing.usage.threshold` | Wird ausgelöst, wenn ein Nutzungsschwellenwert erreicht wird. |

**Verifizierung**: Verifizieren Sie immer den `X-Truthlocks-Signature` Header mit dem gemeinsamen Geheimnis Ihres Endpunkts. Weitere Informationen zu Ereignistypen, Signaturverifizierung und Wiederholungsverhalten finden Sie im [Webhooks-Leitfaden](https://docs.truthlocks.com/de/guides/webhooks.md).

## 4. Proof-Bundles

Ein Proof Bundle ist ein signiertes JSON-Objekt, das Folgendes enthält:

1. **Originaldaten**: Die von Ihnen geprägte Nutzlast.
2. **Aussteller-Signatur**: Ihr kryptografischer Nachweis der Absicht.
3. **Plattform-Checkpoint**: Truthlocks' Nachweis des Netzwerkzustands zum Zeitpunkt der Prägung.

## 5. Ratenbegrenzungen & Kontingente

Limits werden pro Mandant basierend auf Ihrem Abonnement-Tier angewendet:

* **Global Burst**: 500 Anfragen pro 10 Sekunden.
* **Monatliches Prägekontingent**: Definiert in Ihrer Enterprise Agreement (einsehbar in `/v1/billing/usage`).

***

## 6. Umgebungstrennung

Wir bieten zwei verschiedene Umgebungen:

* **Sandbox (`sandbox.truthlocks.com`)**: Zum Testen mit Mock-Schlüsseln und ephemeren Daten.
* **Produktion (`api.truthlocks.com`)**: Föderiert für die Ausgabe mit hohem Risiko.

> [!TIP]
>
> Verwenden Sie unsere [SDKs](https://docs.truthlocks.com/de/sdk/js.md), um Wiederholungsversuche, Signaturverifizierung und
> Payload-Serialisierung automatisch.


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