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

A fonte contém um pacote `truthlock` raiz e um cliente `pkg` legado. São interfaces diferentes; não misture nomes de métodos ou tipos de solicitação de um com o outro.

O caminho do módulo raiz é:

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

Instale o módulo público corrigido com `go get github.com/truthlocks/sdk-go@v0.4.0`. Tags mais antigas usavam um caminho de módulo incompatível.

## Configuração do cliente

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

Este é um fragmento para um programa Go que importa o módulo, `os` e `context`. Use uma chave que corresponda ao host. O ID do locatário sozinho não é autenticação; o servidor deriva o espaço de trabalho da credencial.

## Cunhagem

O cliente raiz aceita `MintRequest` com `IssuerID`, `KID`, `Alg` e `PayloadB64URL`. Codifique os bytes originais com `base64.RawURLEncoding.EncodeToString`. Alternativamente, defina `Schema` e `Claims` e deixe `PayloadB64URL` vazio para usar entrada estruturada. Não combine os dois modos de entrada.

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

Este fragmento pertence a uma função que retorna `error`; importe `encoding/base64` e `fmt`, e forneça `ctx`. Use um emissor e uma chave de assinatura já provisionados para o ambiente.

## Contratos de solicitação e resposta

O transporte raiz corrigido executa requisições HTTP e exibe erros HTTP e JSON. Snapshots de fonte anteriores continham um transporte no-op; não trate um retorno bem-sucedido de tal versão como evidência de que uma requisição chegou à Truthlocks. Verifique sua versão de fonte fixada.

Mantenha uma chave de idempotência estável em todas as tentativas de uma gravação e o mesmo corpo. Não assuma que uma nova chamada de método SDK reutiliza a chave anterior. Lide com cancelamentos e erros explicitamente; nunca descarte erros de cunhagem ou verificação.

Use a [referência da API](https://docs.truthlocks.com/pt/api-reference/attestations/mint.md) para campos de wire e o [início rápido HTTP direto](https://docs.truthlocks.com/pt/quickstart.md) ao verificar o comportamento de uma versão de pacote.


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