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

Instale a distribuição cujo pacote de origem é `truthlock`:

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

A importação é `from truthlock import TruthlockClient`. Os nomes de pacotes para integrações MAIP são distribuições separadas e não implicam a mesma API.

## Cunhar com uma chave de assinatura 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)
```

Defina as quatro variáveis de ambiente primeiro. Use uma chave de sandbox, emissor e chave disponíveis para assinatura nesse ambiente. O registro de chave pública não provisiona uma chave de assinatura privada.

## Verificar

Chame `client.verify.verify_online(attestation_id=record.attestation_id)` e inspecione o veredito. Adicione `payload_b64url` ao verificar os bytes originais. O backend usa vereditos de wire em maiúsculas; o SDK corrigido os normaliza para seus valores de enum em minúsculas. A versão 0.4.0 e posteriores incluem a análise de veredito corrigida.

## Limites de versão e repetição

Os grupos de recursos principais implementados são `issuers`, `keys`, `attestations`, `verify` e `receipts`. Não chame métodos de recurso hipotéticos `consumer`, `governance` ou `audit` neste cliente.

A emissão gera um cabeçalho de idempotência. Tentar novamente a mesma solicitação interna pode mantê-lo, mas chamar a emissão novamente cria uma nova operação, a menos que a mesma chave seja fornecida. Preserve chaves e corpos de solicitação em trabalhos de aplicativo duráveis. Um tempo limite não prova que uma gravação falhou.

Use o [início rápido HTTP](https://docs.truthlocks.com/pt/quickstart.md) para comparar um lançamento com o contrato de wire real. Instale a versão 0.4.0 ou posterior para usar o transporte corrigido e os campos do pacote de prova.


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