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

# Go SDK

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:

```text theme={null}
github.com/truthlocks/sdk-go
```

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

```go theme={null}
client := truthlock.NewClient(truthlock.Config{
    BaseURL: "https://sandbox-api.truthlocks.com",
    APIKey: os.Getenv("TRUTHLOCKS_API_KEY"),
})
```

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.

```go theme={null}
record, err := client.Attestations.Mint(ctx, &truthlock.MintRequest{
    IssuerID: os.Getenv("TRUTHLOCKS_ISSUER_ID"),
    KID: os.Getenv("TRUTHLOCKS_KEY_ID"),
    Alg: truthlock.Algorithm(os.Getenv("TRUTHLOCKS_ALGORITHM")),
    PayloadB64URL: base64.RawURLEncoding.EncodeToString([]byte(`{"subject":"demo-record"}`)),
})
if err != nil { return err }
fmt.Println(record.AttestationID)
```

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](https://docs.truthlocks.com/de/api-reference/attestations/mint.md) für Wire-Felder und den [direkten HTTP-Schnellstart](https://docs.truthlocks.com/de/quickstart.md) beim Überprüfen des Verhaltens einer Paketversion.


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