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

La fuente contiene un paquete raíz `truthlock` y un cliente heredado `pkg`. Son interfaces diferentes; no mezcle nombres de métodos o tipos de solicitud de uno con el otro.

La ruta del módulo raíz es:

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

Instale el módulo público corregido con `go get github.com/truthlocks/sdk-go@v0.4.0`. Las etiquetas antiguas usaban una ruta de módulo incompatible.

## Configuración del cliente

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

Este es un fragmento para un programa Go que importa el módulo, `os` y `context`. Use una clave que coincida con el host. El ID de inquilino por sí solo no es autenticación; el servidor deriva el espacio de trabajo de la credencial.

## Acuñación

El cliente raíz acepta `MintRequest` con `IssuerID`, `KID`, `Alg` y `PayloadB64URL`. Codifique los bytes originales con `base64.RawURLEncoding.EncodeToString`. Alternativamente, configure `Schema` y `Claims` y deje `PayloadB64URL` vacío para usar la entrada estructurada. No combine los dos 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 pertenece a una función que devuelve `error`; importe `encoding/base64` y `fmt`, y proporcione `ctx`. Utilice un emisor y una clave de firma ya aprovisionados para el entorno.

## Contratos de solicitud y respuesta

El transporte raíz corregido realiza solicitudes HTTP y muestra errores HTTP y JSON. Las instantáneas de origen anteriores contenían un transporte sin operación; no trate un retorno exitoso de dicha versión como evidencia de que una solicitud llegó a Truthlocks. Verifique su versión de origen anclada.

Mantenga una clave de idempotencia estable en los reintentos de una escritura y el mismo cuerpo. No asuma que una nueva llamada al método SDK reutiliza la clave anterior. Maneje la cancelación y los errores explícitamente; nunca descarte errores de acuñación o verificación.

Utilice la [referencia de la API](https://docs.truthlocks.com/es/api-reference/attestations/mint.md) para los campos de cable y el [inicio rápido HTTP directo](https://docs.truthlocks.com/es/quickstart.md) al verificar el comportamiento de la versión de un paquete.


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