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

# Spécification d'enregistrement signé

> Comment construire, conserver et vérifier une attestation sans confondre les revendications avec les résultats de vérification.

Révision : 2026-10-13.

## La charge utile signée

L'émission accepte soit des `schema` et `claims` structurés, soit une `payload_b64url` contenant les octets exacts à signer. Ne fournissez pas les deux formes. Préservez la charge utile, la réponse et la clé d'idempotence. Une charge utile encodée n'est pas un chiffrement.

L'enregistrement comprend son identifiant, l'émetteur, l'heure d'émission, le condensat de la charge utile, l'algorithme de signature déclaré, l'identifiant de la clé, la signature et les références de transparence. Choisissez une clé active, disponible pour la signature et prenant en charge l'algorithme demandé. L'enregistrement de la clé publique seule ne rend pas une clé de signature privée disponible.

## Expiration

Pour les entrées structurées, l'optionnel `expires_at_unix` est un horodatage Unix entier en secondes. Il fait partie de la charge utile JSON signée. Pour les entrées encodées, placez ce champ à la racine de la charge utile JSON avant de l'encoder ; n'envoyez pas de champ d'expiration non signé séparé.

La date doit être postérieure à l'émission. La vérification renvoie `EXPIRED` après cet instant. L'expiration stockée ne peut pas être prolongée ou supprimée sur place ; émettez un remplacement. L'omission de l'expiration n'invente pas une durée de vie par défaut. Les enregistrements historiques sans expiration stockée ne se voient pas attribuer une expiration rétrospectivement. Les dates figurant dans les revendications, telles que `claims.expiry_date`, ne définissent pas automatiquement l'expiration de l'attestation.

## Risque et réclamations de l'émetteur

L'instantané de gouvernance enregistre la classification de l'émetteur au moment de l'émission. Une cote de risque de l'émetteur n'est pas un score de risque automatisé pour le contenu du document. `unknown` signifie qu'aucune évaluation n'a été enregistrée. Les nouvelles approbations du personnel nécessitent une évaluation étayée par des preuves ; elles ne réécrivent pas les anciens instantanés.

## Références de transparence

`log.leaf_index` est basé sur zéro : zéro peut être la première entrée réelle. Une référence manquante ou indisponible est distincte de zéro. `log.leaf_hash` identifie la feuille enregistrée. Ces champs seuls n'établissent pas une vérification d'inclusion réussie ; vérifiez la preuve et le point de contrôle par rapport à une clé de confiance.

## Vérification et exportation

Fournissez la charge utile originale pour vérifier l'intégrité de la charge utile et sa signature. Lisez le verdict et les raisons ensemble : `INCOMPLETE` avec `signature_verified: false` et `payload_not_provided` signifie que la vérification de la signature de la charge utile n'a pas été effectuée. Une comparaison de hachage de fichier vérifie l'empreinte fournie par rapport à l'empreinte stockée ; elle ne prouve pas la propriété ou la véracité du contenu du fichier.

Les certificats de la Console privée nécessitent un accès à l'espace de travail. Un téléchargement de certificat ne publie pas d'enregistrement. La vérification publique est soumise à l'enregistrement et à l'environnement disponibles pour le vérificateur public.

Utilisez [Mint Attestation](https://docs.truthlocks.com/fr/api-reference/attestations/mint.md), [vérification](https://docs.truthlocks.com/fr/api-reference/verify.md) et le [démarrage rapide](https://docs.truthlocks.com/fr/quickstart.md) pour les formats de requête. Conservez une requête inchangée lors de la nouvelle tentative d'une frappe ; la modification des champs signés sous la même clé d'idempotence est un conflit.


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