Zum Hauptinhalt springen
Die Quelle enthält ein Root-truthlock-Paket und einen Legacy-pkg-Client. Es handelt sich um unterschiedliche Schnittstellen; mischen Sie keine Methodennamen oder Anfragetypen von einer mit der anderen. Der Root-Modulpfad ist:
Installieren Sie das korrigierte öffentliche Modul mit go get github.com/truthlocks/sdk-go@v0.4.0. Ältere Tags verwendeten einen inkompatiblen Modulpfad.

Client-Konfiguration

Dies ist ein Fragment für ein Go-Programm, das das Modul os und context importiert. Verwenden Sie einen Schlüssel, der zum Host passt. Die Mandanten-ID allein ist keine Authentifizierung; der Server leitet den Arbeitsbereich aus den Anmeldeinformationen ab.

Prägen

Der Root-Client akzeptiert MintRequest mit IssuerID, KID, Alg und PayloadB64URL. Kodieren Sie Original-Bytes mit base64.RawURLEncoding.EncodeToString. Alternativ können Sie Schema und Claims setzen und PayloadB64URL leer lassen, um strukturierte Eingaben zu verwenden. Kombinieren Sie die beiden Eingabemodi nicht.
Dieses Fragment gehört in eine Funktion, die error zurückgibt; importieren Sie encoding/base64 und fmt und stellen Sie ctx bereit. Verwenden Sie einen Aussteller und einen Signierschlüssel, die bereits für die Umgebung bereitgestellt wurden.

Anfrage- und Antwortverträge

Der korrigierte Root-Transport führt HTTP-Anfragen aus und zeigt HTTP- und JSON-Fehler an. Frühere Quell-Snapshots enthielten einen No-Op-Transport; behandeln Sie eine erfolgreiche Rückgabe von einer solchen Version nicht als Beweis dafür, dass eine Anfrage Truthlocks erreicht hat. Überprüfen Sie Ihre angeheftete Quellversion. Behalten Sie einen stabilen Idempotenzschlüssel bei Wiederholungen eines Schreibvorgangs und desselben Bodys bei. Gehen Sie nicht davon aus, dass ein neuer SDK-Methodenaufruf den vorherigen Schlüssel wiederverwendet. Behandeln Sie Abbrüche und Fehler explizit; verwerfen Sie niemals Präge- oder Verifizierungsfehler. Verwenden Sie die API-Referenz für Wire-Felder und den direkten HTTP-Schnellstart beim Überprüfen des Verhaltens einer Paketversion.