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

# Inicio rápido

> Acuñe y verifique un registro utilizando el emisor y la clave de firma de su espacio de trabajo.

Una atestación firma una carga útil y registra su hash. La verificación comprueba la integridad criptográfica y el estado del registro; no establece de forma independiente que las afirmaciones del emisor sean verdaderas.

## Antes de empezar

En [Console](https://console.truthlocks.com), seleccione su espacio de trabajo y entorno. Obtenga una clave API, un ID de emisor y una clave activa disponible para la firma del lado del servidor. Utilice el algoritmo que se muestra para esa clave. El registro de una clave pública por sí solo no le da al servicio de firma su clave privada.

Use `https://sandbox-api.truthlocks.com` con una clave de sandbox (`tl_test_`). Use `https://api.truthlocks.com` con una clave de producción (`tl_live_`) y un espacio de trabajo aprobado. Los recursos y las credenciales deben pertenecer al mismo entorno. No envíe `X-Tenant-ID` para elegir un espacio de trabajo: se deriva de sus credenciales.

## Acuñar un registro

Este ejemplo utiliza la biblioteca estándar de Python 3. Establezca las cuatro variables de entorno requeridas a través de su shell o administrador de secretos. Establezca `TRUTHLOCKS_BASE_URL` solo si cambia de sandbox a producción.

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

Los errores HTTP generan `urllib.error.HTTPError`. Maneje los errores y los tiempos de espera en su aplicación; conserve la misma clave de idempotencia y cuerpo al reintentar un resultado de acuñación incierto.

La respuesta utiliza `attestation_id`, `issued_at_unix`, `signature` y `log`. No repite las reclamaciones como un `payload` de nivel superior. Conserve los bytes originales para comprobaciones de integridad posteriores.

## Verificar el resultado

Utilice la [referencia de verificación](https://docs.truthlocks.com/es/api-reference/verify.md) con el `attestation_id` devuelto. Suministre `payload_b64url` para verificar los bytes originales exactos, o `document_hash_hex` para comparar un hash de archivo. Inspeccione `verdict` y `reasons`: una respuesta HTTP exitosa por sí sola no significa que el registro sea válido.

## Solución de problemas

* **401 o 403:** verifique las credenciales, el entorno, los permisos y la aprobación del espacio de trabajo.
* **400:** verifique los UUID, el encabezado de idempotencia y la codificación base64url sin relleno.
* **Error de clave o política:** confirme que el emisor y la clave se pueden usar para firmar y que el algoritmo coincide.
* **Tiempo de espera:** reintente con el cuerpo original y la clave de idempotencia, en lugar de crear una nueva acuñación.

Continuar con [parámetros de acuñación](https://docs.truthlocks.com/es/api-reference/attestations/mint.md), [autenticación](https://docs.truthlocks.com/es/security/auth.md), y [entornos](https://docs.truthlocks.com/es/environments.md).


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