Zum Hauptinhalt springen
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.

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:
  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.
Verwenden Sie unsere SDKs, um Wiederholungsversuche, Signaturverifizierung und Payload-Serialisierung automatisch.