Zum Hauptinhalt springen
Installieren Sie das öffentliche Paket:
Verwenden Sie Node.js 18 oder höher. Die Kernressourcen sind issuers, keys, attestations, verify, audit und receipts. Gehen Sie nicht davon aus, dass jede öffentliche API eine Komfortmethode in diesem Paket hat; verwenden Sie die Operationsreferenz und client.request wo angebracht.

Authentifizierung konfigurieren

Die API-Schlüssel-Strategie ist service, nicht apiKey. Für eine Benutzeroperation verwenden Sie auth: { type: 'bearer', token } mit einem gültigen Benutzer-Token. tenantId authentifiziert oder wechselt keine Arbeitsbereiche. Verwenden Sie keine reine Mandanten-Authentifizierung.

Mint

Verwenden Sie einen vorhandenen Aussteller und einen Schlüssel, der für die serverseitige Signierung verfügbar ist. Verwenden Sie entweder kodierte Original-Bytes oder strukturierte schema- und claims-Eingaben.
Setzen Sie alle drei Umgebungsvariablen, bevor Sie das Snippet ausführen. Für strukturierte Eingaben ersetzen Sie payload_b64url durch schema: "attestation" und claims: { subject: "demo-record" }; senden Sie niemals beide Modi. Die Registrierung eines öffentlichen Schlüssels allein stellt keinen privaten Signaturschlüssel bereit.

Wiederholungsversuche und Antwortverarbeitung

Der Client fügt POST- und PUT-Anfragen einen Idempotenz-Header hinzu. Ein neuer Methodenaufruf generiert einen neuen Schlüssel, daher ist es kein sicherer Wiederholungsversuch eines unsicheren früheren Schreibvorgangs, es sei denn, Sie behalten und übergeben denselben Schlüssel. client.request akzeptiert eine idempotencyKey-Option. Automatische Wiederholungen sind auf Lesevorgänge und unterstützte Bescheinigungs-/Empfangsschreibvorgänge mit einem expliziten Schlüssel beschränkt; beliebige Schreibvorgänge werden nicht einfach wiederholt, weil ein Schlüssel bereitgestellt wurde. Überprüfen Sie die Verifizierung verdict und reasons. Ein aufgelöstes Promise oder HTTP 200 allein ist kein gültiges Verifizierungsergebnis. Stimmen Sie die installierte Paketversion mit ihren Typdeklarationen ab; neu korrigierter Quellcode ist kein Beweis dafür, dass eine ältere installierte Version die Korrekturen enthält. Ein unabhängiges Integrationsbeispiel und die aktuelle Vertragsspezifikation finden Sie im direkten HTTP-Beispiel und in der API-Referenz.