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.
3. Webhooks & Eventing
Truthlocks verwendet Webhooks, um Ihr System über Zustandsänderungen zu informieren.
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.
4. Proof-Bundles
Ein Proof Bundle ist ein signiertes JSON-Objekt, das Folgendes enthält:- Originaldaten: Die von Ihnen geprägte Nutzlast.
- Aussteller-Signatur: Ihr kryptografischer Nachweis der Absicht.
- 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.

