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

# Vérifier l'attestation

> Vérifiez le statut de l'enregistrement, les métadonnées de l'émetteur et les preuves disponibles. Fournissez la charge utile_b64url originale exacte pour vérifier la signature cryptographique. Une recherche par ID uniquement ou par empreinte de fichier uniquement renvoie INCOMPLET avec signature_verified false si aucune défaillance plus grave ne s'applique. VALIDE signifie que la charge utile fournie a passé les vérifications de signature ; cela ne prouve pas la véracité des affirmations ni ne garantit que les vérifications facultatives de politique et de transparence sont terminées. Inspectez les raisons et log.proof_checked. Les requêtes publiques n'ont pas besoin de clé API ; les requêtes authentifiées sont limitées et mesurées par rapport à l'espace de travail de l'appelant.

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

| Entrée | Ce qu'il vérifie |
| - | - |
| `attestation_id` | Trouve un enregistrement accessible et vérifie son statut actuel, les métadonnées de l'émetteur et les preuves de journal disponibles. |
| ID plus `payload_b64url` | Vérifie également le condensé de la charge utile et la signature par rapport à la clé publique enregistrée. Encodez les octets d'origine ; le reformatage de JSON peut modifier ces octets. |
| ID plus `document_hash_hex` | Compare une empreinte SHA-256 fournie avec l'empreinte du document enregistrée. Cela ne remplace pas la vérification de la charge utile signée. |

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

| Verdict | Signification |
| - | - |
| `VALID` | La charge utile fournie a passé sa vérification de signature et aucune erreur bloquante n'a été renvoyée. Inspectez les raisons et les vérifications individuelles. |
| `INCOMPLETE` | Le contenu original requis n'a pas été fourni ; la signature n'a pas été vérifiée. |
| `ALTERED` | Une charge utile, une signature ou une empreinte de document fournie n'a pas réussi un contrôle d'intégrité. |
| `REVOKED` | L'enregistrement a été révoqué. |
| `SUPERSEDED` | Un enregistrement plus récent remplace celui-ci. Demandez à l'émetteur son enregistrement actuel. |
| `EXPIRED` | L'enregistrement ou la clé de signature a expiré. |
| `INVALID` | Une entrée requise ou une vérification a échoué. |
| `NOT_FOUND` | Aucun enregistrement accessible ne correspondait à la requête et à son environnement. |
| `UNKNOWN_ISSUER` | La clé de signature de l'émetteur n'a pas pu être acceptée. |

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

> [!WARNING]
>
> 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.


## OpenAPI

````yaml fr/mint-openapi.yaml POST /v1/verify
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks est une infrastructure de vérification universelle pour les
    documents, les identifiants et les actifs numériques.

    Cette spécification définit l'API canonique pour interagir avec les services
    Truthlocks.


    ## URL de base

    - **Production** : `https://api.truthlocks.com`

    - **Sandbox** : `https://sandbox-api.truthlocks.com`


    ## Authentification

    - **Clés API** : Utilisez l'en-tête `X-API-Key` pour les opérations de
    machine à machine

    - **Jetons Bearer** : Utilisez `Authorization: Bearer <jwt>` pour les
    opérations initiées par l'utilisateur


    ## Identité du locataire

    En production, l'identité du locataire est dérivée du contexte authentifié
    (clé API ou JWT).

    L'en-tête `X-Tenant-ID` est ignoré en production pour éviter l'usurpation
    d'identité.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: API de production
  - url: https://sandbox-api.truthlocks.com
    description: Environnement de bac à sable
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestion des clés API et des jetons
  - name: Issuers
    description: Enregistrement de l'émetteur et gestion de la confiance
  - name: Keys
    description: Gestion des clés cryptographiques pour les émetteurs
  - name: Attestations
    description: Cycle de vie de l'attestation (créer, révoquer, remplacer)
  - name: Verification
    description: Vérification des attestations et lots de preuves
  - name: Governance
    description: Flux de travail de gouvernance de l'émetteur (administrateur uniquement)
  - name: Identity
    description: Gestion de l'organisation, des utilisateurs et des rôles
  - name: Audit
    description: Requêtes d'événements d'audit
  - name: Tenant Console
    description: Points de terminaison du profil et du cycle de vie du locataire
  - name: Health
    description: Points de terminaison de l'état et de la disponibilité du service
  - name: Risk
    description: Ingestion de signaux de risque et détection de fraude
  - name: Risk Enforcement
    description: >-
      Actions d'application des risques — blocage, défi, quarantaine et
      configuration
  - name: Billing
    description: Gestion de la facturation, des abonnements et des modules complémentaires
  - name: Machine Identity
    description: >-
      Protocole d'identité d'agent machine (MAIP) — enregistrement d'agent,
      sessions, confiance, témoin, conformité, orchestration et observabilité
externalDocs:
  description: API de transparence en lecture seule (spécification de service séparée)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/verify:
    post:
      tags:
        - Verification
      summary: Vérifier l'attestation
      description: >-
        Vérifiez le statut de l'enregistrement, les métadonnées de l'émetteur et
        les preuves disponibles. Fournissez la charge utile_b64url originale
        exacte pour vérifier la signature cryptographique. Une recherche par ID
        uniquement ou par empreinte de fichier uniquement renvoie INCOMPLET avec
        signature_verified false si aucune défaillance plus grave ne s'applique.
        VALIDE signifie que la charge utile fournie a passé les vérifications de
        signature ; cela ne prouve pas la véracité des affirmations ni ne
        garantit que les vérifications facultatives de politique et de
        transparence sont terminées. Inspectez les raisons et log.proof_checked.
        Les requêtes publiques n'ont pas besoin de clé API ; les requêtes
        authentifiées sont limitées et mesurées par rapport à l'espace de
        travail de l'appelant.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                attestation:
                  description: >-
                    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.
                  nullable: true
                  properties:
                    attestation_id:
                      type: string
                    document_hash:
                      type: string
                    expires_at_unix:
                      type: integer
                      format: int64
                      nullable: true
                      description: >-
                        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:
                      type: integer
                    issuer_id:
                      type: string
                    log:
                      type: object
                      properties:
                        log_id:
                          type: string
                        leaf_index:
                          type: integer
                          nullable: true
                          description: >-
                            Index de feuille de transparence basé sur zéro. Nul
                            signifie que la référence du journal n'a pas pu être
                            récupérée ; zéro est une première entrée valide.
                        status:
                          type: string
                          enum:
                            - recorded
                            - unavailable
                          description: >-
                            Disponibilité de la référence de journal stockée ;
                            cela n'établit pas un verdict d'inclusion vérifié.
                        leaf_hash:
                          type: string
                        proof_url:
                          type: string
                    payload_hash:
                      type: string
                    signature:
                      type: object
                      properties:
                        alg:
                          type: string
                        kid:
                          type: string
                        value:
                          type: string
                    status:
                      type: string
                    tenant_id:
                      type: string
                      format: uuid
                    version:
                      type: string
                  type: object
                attestation_id:
                  type: string
                document_hash_hex:
                  type: string
                payload_b64url:
                  type: string
              type: object
      responses:
        '200':
          description: Résultat de la vérification
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyResponse'
              examples:
                valid:
                  summary: Valid attestation
                  value:
                    verdict: VALID
                    valid: true
                    details:
                      issuer_id: 550e8400-e29b-41d4-a716-446655440000
                      issuer_name: Acme University
                      log_index: 42
                revoked:
                  summary: Revoked attestation
                  value:
                    verdict: REVOKED
                    valid: false
                    details:
                      revoked_at: '2026-01-13T15:00:00.000Z'
                      reason: Certificate holder no longer employed
      security:
        - APIKey: []
        - {}
components:
  schemas:
    VerifyResponse:
      type: object
      required:
        - verdict
      description: >-
        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.
      properties:
        verdict:
          $ref: '#/components/schemas/Verdict'
        signature_verified:
          type: boolean
          description: >-
            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:
          type: array
          items:
            type: string
        attestation_id:
          type: string
          format: uuid
        issuer_id:
          type: string
          format: uuid
        expires_at_unix:
          type: integer
          format: int64
          nullable: true
          description: >-
            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:
          type: integer
          format: int64
          description: >-
            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:
          type: string
          description: Identifiant de la clé de signature.
        alg:
          type: string
          description: Algorithme de signature déclaré.
        payload_hash:
          type: string
          description: Digest SHA-256 encodé en Base64url de la charge utile canonique.
        document_hash:
          type: string
          description: >-
            Empreinte hexadécimale SHA-256 du fichier original, lorsqu'il est
            stocké.
        log:
          type: object
          properties:
            log_id:
              type: string
            leaf_index:
              type: integer
              format: int64
              nullable: true
              description: >-
                Index de la feuille de transparence vérifiée ; nul lorsque la
                vérification de la preuve n'était pas disponible. Zéro est une
                première feuille valide.
            leaf_hash:
              type: string
              description: >-
                Digest de la feuille d'inclusion vérifiée, lorsqu'il est
                disponible.
            proof_checked:
              type: boolean
              description: >-
                Si l'inclusion de la transparence a été vérifiée avec succès
                pour cette réponse.
        governance:
          type: object
          properties:
            issuer_display_name:
              type: string
            issuer_status:
              type: string
            issuer_trust_tier:
              type: string
            issuer_risk_rating:
              type: string
            issuer_jurisdiction:
              type: string
            primary_color:
              type: string
            accent_color:
              type: string
            logo_url:
              type: string
            snapshot_status:
              type: string
            snapshot_trust_tier:
              type: string
            snapshot_risk_rating:
              type: string
            snapshot_jurisdiction:
              type: string
    Verdict:
      type: string
      enum:
        - VALID
        - INCOMPLETE
        - INVALID
        - REVOKED
        - ALTERED
        - SUPERSEDED
        - EXPIRED
        - UNKNOWN_ISSUER
        - NOT_FOUND
      description: >-
        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.
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clé API pour l'authentification machine-à-machine
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT pour les opérations initiées par l'utilisateur

````

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