Passer au contenu principal
POST
Vérifier l'attestation
Vérifiez le statut actuel d’un enregistrement et les preuves disponibles. Pour vérifier sa signature cryptographique, envoyez la charge utile signée originale exacte comme payload_b64url. Un ID d’enregistrement ou une empreinte de fichier seul ne peut pas fournir ces octets.

Choisissez la vérification dont vous avez besoin

Une vérification par ID seul ou par empreinte numérique seule renvoie INCOMPLETE et signature_verified: false à moins qu’un résultat plus fort tel que REVOKED, EXPIRED ou ALTERED ne s’applique. Fournissez la charge utile originale pour une vérification complète de la signature. Un attestation en ligne doit identifier un enregistrement enregistré avec attestation_id. L’état en ligne et l’identité de la clé sont chargés à partir de cet enregistrement ; les champs fournis par l’appelant ne peuvent pas remplacer son émetteur ou sa révocation. Utilisez un vérificateur hors ligne compatible pour les vérifications de signature autonomes.

Interpréter la réponse

signature_verified signale spécifiquement la vérification de la signature. log.proof_checked signale la vérification réussie de l’inclusion de la transparence. Une preuve manquante produit une raison et un index de feuille nul ; zéro est une première feuille légitime. Une valeur expires_at_unix absente ne signifie pas qu’une nouvelle expiration doit être inventée pour un enregistrement historique.
Une signature valide ne prouve pas la propriété, la validité légale ou la véracité de chaque affirmation. Lisez reasons, la gouvernance actuelle de l’émetteur et les preuves disponibles avant de vous fier à un enregistrement. Les vérifications facultatives de politique ou de journal peuvent être indisponibles même si la signature de la charge utile est valide.

Authentification et limites

La vérification publique ne nécessite pas de clé API. Les appels authentifiés utilisent l’espace de travail et l’environnement de l’appelant et peuvent être soumis à son allocation de vérification. Les limites de débit du service s’appliquent toujours aux requêtes publiques. Un enregistrement privé ou de bac à sable peut ne pas être disponible via une recherche de production anonyme. Partagez un enregistrement accessible en utilisant https://verify.truthlocks.com/proof/{attestation_id}. Une URL partagée n’accorde pas l’accès aux charges utiles privées.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
attestation
object | null

Enveloppe de recherche en ligne. Un attestation_id enregistré est requis ici ou au niveau de la requête. Le statut, l'émetteur, la clé et l'heure d'émission stockés font autorité ; les copies fournies ne peuvent pas les remplacer.

attestation_id
string
document_hash_hex
string
payload_b64url
string

Réponse

200 - application/json

Résultat de la vérification

Preuve de vérification publique. Inspectez les raisons et les vérifications individuelles ; une vérification par ID seul ne vérifie pas le contenu original fourni par l'appelant.

verdict
enum<string>
requis

Examinez les raisons, les entrées de vérification fournies et log.proof_checked en parallèle de ce verdict. VALID seul n'établit pas la propriété ni ne prouve chaque affirmation dans l'enregistrement.

Options disponibles:
VALID,
INCOMPLETE,
INVALID,
REVOKED,
ALTERED,
SUPERSEDED,
EXPIRED,
UNKNOWN_ISSUER,
NOT_FOUND
signature_verified
boolean

Vrai uniquement lorsque la charge utile originale fournie a passé la vérification de signature cryptographique. Les vérifications par ID seul et par empreinte seule renvoient faux.

reasons
string[]
attestation_id
string<uuid>
issuer_id
string<uuid>
expires_at_unix
integer<int64> | null

Expiration signée enregistrée en secondes Unix ; null signifie qu'aucune expiration n'est enregistrée. Les enregistrements hérités ne se voient pas attribuer de nouvelle expiration.

issued_at_unix
integer<int64>

Heure d'émission originale stockée en secondes Unix. Ce n'est pas l'heure de la vérification actuelle ou du téléchargement du certificat. Absent si non disponible.

kid
string

Identifiant de la clé de signature.

alg
string

Algorithme de signature déclaré.

payload_hash
string

Digest SHA-256 encodé en Base64url de la charge utile canonique.

document_hash
string

Empreinte hexadécimale SHA-256 du fichier original, lorsqu'il est stocké.

log
object
governance
object