Avant de commencer
Dans Console, 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. Utilisezhttps://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éfinissezTRUTHLOCKS_BASE_URL uniquement si vous passez du sandbox à la production.
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 avec leattestation_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.

