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

# SDK Go

La source contient un package `truthlock` racine et un client `pkg` hérité. Ce sont des interfaces différentes ; ne mélangez pas les noms de méthodes ou les types de requêtes de l'un avec l'autre.

Le chemin du module racine est :

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

Installez le module public corrigé avec `go get github.com/truthlocks/sdk-go@v0.4.0`. Les anciennes balises utilisaient un chemin de module incompatible.

## Configuration du client

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

Ceci est un fragment pour un programme Go important le module, `os`, et `context`. Utilisez une clé correspondant à l'hôte. L'ID de locataire seul n'est pas une authentification ; le serveur dérive l'espace de travail à partir de l'accréditation.

## Création

Le client racine accepte `MintRequest` avec `IssuerID`, `KID`, `Alg` et `PayloadB64URL`. Encodez les octets d'origine avec `base64.RawURLEncoding.EncodeToString`. Alternativement, définissez `Schema` et `Claims` et laissez `PayloadB64URL` vide pour utiliser une entrée structurée. Ne combinez pas les deux modes d'entrée.

```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)
```

Ce fragment appartient à une fonction renvoyant `error` ; importez `encoding/base64` et `fmt`, et fournissez `ctx`. Utilisez un émetteur et une clé de signature déjà provisionnés pour l'environnement.

## Contrats de requête et de réponse

Le transport racine corrigé effectue des requêtes HTTP et signale les erreurs HTTP et JSON. Les instantanés de source antérieurs contenaient un transport sans opération ; ne traitez pas un retour réussi d'une telle version comme une preuve qu'une requête a atteint Truthlocks. Vérifiez votre version source épinglée.

Conservez une clé d'idempotence stable lors des tentatives d'une écriture et du même corps. Ne supposez pas qu'un nouvel appel de méthode SDK réutilise la clé précédente. Gérez explicitement l'annulation et les erreurs ; ne jamais ignorer les erreurs de frappe ou de vérification.

Utilisez la [référence API](https://docs.truthlocks.com/fr/api-reference/attestations/mint.md) pour les champs filaires et le [guide de démarrage rapide HTTP direct](https://docs.truthlocks.com/fr/quickstart.md) lors de la vérification du comportement d'une version de package.


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