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

# Início Rápido

> Emita e verifique um registro usando o emissor e a chave de assinatura do seu espaço de trabalho.

Uma atestação assina um payload e regista o seu hash. A verificação verifica a integridade criptográfica e o status do registo; não estabelece independentemente que as alegações do emissor são verdadeiras.

## Antes de começar

No [Console](https://console.truthlocks.com), selecione seu espaço de trabalho e ambiente. Obtenha uma chave de API, ID do emissor e uma chave ativa disponível para assinatura no lado do servidor. Use o algoritmo mostrado para essa chave. Registrar apenas uma chave pública não fornece ao serviço de assinatura sua chave privada.

Use `https://sandbox-api.truthlocks.com` com uma chave sandbox (`tl_test_`). Use `https://api.truthlocks.com` com uma chave de produção (`tl_live_`) e um espaço de trabalho aprovado. Recursos e credenciais devem pertencer ao mesmo ambiente. Não envie `X-Tenant-ID` para escolher um espaço de trabalho: ele é derivado de suas credenciais.

## Cunhar um registro

Este exemplo usa a biblioteca padrão do Python 3. Defina as quatro variáveis de ambiente necessárias através do seu shell ou gerenciador de segredos. Defina `TRUTHLOCKS_BASE_URL` apenas se estiver mudando do sandbox para a produção.

```python theme={null}
import base64
import json
import os
import urllib.request
import uuid

base_url = os.environ.get("TRUTHLOCKS_BASE_URL", "https://sandbox-api.truthlocks.com").rstrip("/")
payload = json.dumps({"subject": "demo-record", "message": "Example issuer claim"},
                     separators=(",", ":")).encode("utf-8")
body = {
    "issuer_id": os.environ["TRUTHLOCKS_ISSUER_ID"],
    "kid": os.environ["TRUTHLOCKS_KEY_ID"],
    "alg": os.environ["TRUTHLOCKS_ALGORITHM"],
    "content_type": "application/json",
    "payload_b64url": base64.urlsafe_b64encode(payload).decode("ascii").rstrip("="),
}
# Retain this value and the same body if retrying this mint request.
idempotency_key = str(uuid.uuid4())
request = urllib.request.Request(
    base_url + "/v1/attestations/mint",
    data=json.dumps(body).encode("utf-8"),
    headers={"Content-Type": "application/json",
             "X-API-Key": os.environ["TRUTHLOCKS_API_KEY"],
             "Idempotency-Key": idempotency_key},
    method="POST",
)
with urllib.request.urlopen(request, timeout=30) as response:
    record = json.load(response)
print("Attestation ID:", record["attestation_id"])
print("Recorded at (Unix seconds):", record["issued_at_unix"])
```

Erros HTTP levantam `urllib.error.HTTPError`. Lide com erros e tempos limite em seu aplicativo; preserve a mesma chave de idempotência e corpo ao tentar novamente um resultado de cunhagem incerto.

A resposta usa `attestation_id`, `issued_at_unix`, `signature` e `log`. Ela não ecoa as reivindicações como um `payload` de nível superior. Mantenha os bytes originais para verificações de integridade subsequentes.

## Verificar o resultado

Use a [referência de verificação](https://docs.truthlocks.com/pt/api-reference/verify.md) com o `attestation_id` retornado. Forneça `payload_b64url` para verificar os bytes originais exatos, ou `document_hash_hex` para comparar um hash de arquivo. Inspecione `verdict` e `reasons`: uma resposta HTTP bem-sucedida por si só não significa que o registro é válido.

## Solução de problemas

* **401 ou 403:** verifique credenciais, ambiente, permissões e aprovação do espaço de trabalho.
* **400:** verifique UUIDs, o cabeçalho de idempotência e a codificação base64url sem preenchimento.
* **Erro de chave ou política:** confirme se o emissor e a chave podem ser usados para assinatura e se o algoritmo corresponde.
* **Tempo limite:** tente novamente com o corpo original e a chave de idempotência, em vez de criar um novo atestado.

Continue com [parâmetros de cunhagem](https://docs.truthlocks.com/pt/api-reference/attestations/mint.md), [autenticação](https://docs.truthlocks.com/pt/security/auth.md), e [ambientes](https://docs.truthlocks.com/pt/environments.md).


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