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

Instale la distribución cuyo paquete fuente es `truthlock`:

```bash theme={null}
python -m pip install "truthlock>=0.4.0"
```

La importación es `from truthlock import TruthlockClient`. Los nombres de paquetes para las integraciones de MAIP son distribuciones separadas y no implican la misma API.

## Acuñar con una clave de firma existente

```python theme={null}
import base64
import json
import os
from truthlock import TruthlockClient

payload = json.dumps({"subject": "demo-record"}, separators=(",", ":")).encode("utf-8")
with TruthlockClient(
    api_key=os.environ["TRUTHLOCKS_API_KEY"],
    base_url="https://sandbox-api.truthlocks.com",
) as client:
    record = client.attestations.mint(
        issuer_id=os.environ["TRUTHLOCKS_ISSUER_ID"],
        kid=os.environ["TRUTHLOCKS_KEY_ID"],
        alg=os.environ["TRUTHLOCKS_ALGORITHM"],
        payload_b64url=base64.urlsafe_b64encode(payload).decode("ascii").rstrip("="),
    )
    print(record.attestation_id)
```

Establezca primero las cuatro variables de entorno. Utilice una clave de sandbox, un emisor y una clave disponibles para firmar en ese entorno. El registro de clave pública no aprovisiona una clave de firma privada.

## Verificar

Llame a `client.verify.verify_online(attestation_id=record.attestation_id)` e inspeccione el veredicto. Agregue `payload_b64url` al verificar los bytes originales. El backend usa veredictos de cable en mayúsculas; el SDK corregido los normaliza a sus valores de enumeración en minúsculas. La versión 0.4.0 y posteriores incluyen el análisis de veredicto corregido.

## Límites de versión y reintentos

Los grupos de recursos centrales implementados son `issuers`, `keys`, `attestations`, `verify` y `receipts`. No llame a métodos de recursos hipotéticos `consumer`, `governance` o `audit` en este cliente.

La acuñación genera un encabezado de idempotencia. Reintentar la misma solicitud interna puede conservarlo, pero volver a llamar a la acuñación crea una nueva operación a menos que se proporcione la misma clave. Conserve las claves y los cuerpos de las solicitudes en trabajos de aplicación duraderos. Un tiempo de espera no prueba que una escritura falló.

Utilice el [inicio rápido HTTP](https://docs.truthlocks.com/es/quickstart.md) para comparar una versión con el contrato de cable real. Instale la versión 0.4.0 o posterior para usar el transporte corregido y los campos del paquete de prueba.


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