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

# Démarrage rapide

> Émettez et vérifiez un enregistrement en utilisant l'émetteur et la clé de signature de votre espace de travail.

Une attestation signe une charge utile et enregistre son hachage. La vérification contrôle l'intégrité cryptographique et l'état de l'enregistrement ; elle n'établit pas de manière indépendante que les affirmations de l'émetteur sont vraies.

## Avant de commencer

Dans [Console](https://console.truthlocks.com), sélectionnez votre espace de travail et votre environnement. Obtenez une clé API, un ID d'émetteur et une clé active disponible pour la signature côté serveur. Utilisez l'algorithme indiqué pour cette clé. L'enregistrement d'une clé publique seule ne donne pas au service de signature sa clé privée.

Utilisez `https://sandbox-api.truthlocks.com` avec une clé de bac à sable (`tl_test_`). Utilisez `https://api.truthlocks.com` avec une clé de production (`tl_live_`) et un espace de travail approuvé. Les ressources et les identifiants doivent appartenir au même environnement. N'envoyez pas `X-Tenant-ID` pour choisir un espace de travail : il est dérivé de vos identifiants.

## Créer un enregistrement

Cet exemple utilise la bibliothèque standard de Python 3. Définissez les quatre variables d'environnement requises via votre shell ou votre gestionnaire de secrets. Définissez `TRUTHLOCKS_BASE_URL` uniquement si vous passez du sandbox à la production.

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

Les erreurs HTTP déclenchent `urllib.error.HTTPError`. Gérez les erreurs et les délais d'attente dans votre application ; conservez la même clé d'idempotence et le même corps lors de la nouvelle tentative d'un résultat de frappe incertain.

La réponse utilise `attestation_id`, `issued_at_unix`, `signature` et `log`. Elle ne renvoie pas les revendications en tant que `payload` de niveau supérieur. Conservez les octets d'origine pour les vérifications d'intégrité ultérieures.

## Vérifier le résultat

Utilisez la [référence de vérification](https://docs.truthlocks.com/fr/api-reference/verify.md) avec le `attestation_id` retourné. Fournissez `payload_b64url` pour vérifier les octets originaux exacts, ou `document_hash_hex` pour comparer un hachage de fichier. Inspectez `verdict` et `reasons` : une réponse HTTP réussie seule ne signifie pas que l'enregistrement est valide.

## Dépannage

* **401 ou 403 :** vérifiez les identifiants, l'environnement, les autorisations et l'approbation de l'espace de travail.
* **400 :** vérifiez les UUID, l'en-tête d'idempotence et l'encodage base64url non rembourré.
* **Erreur de clé ou de politique :** confirmez que l'émetteur et la clé sont utilisables pour la signature et que l'algorithme correspond.
* **Délai d'attente :** réessayez avec le corps original et la clé d'idempotence, plutôt que de créer une nouvelle attestation.

Continuez avec les [paramètres de frappe](https://docs.truthlocks.com/fr/api-reference/attestations/mint.md), l'[authentification](https://docs.truthlocks.com/fr/security/auth.md) et les [environnements](https://docs.truthlocks.com/fr/environments.md).


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