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

# Émettre une attestation

> Émettez une attestation signée en utilisant un schéma structuré et des revendications, ou une charge utile encodée.
Conservez la même clé d'idempotence et le même corps lors de la nouvelle tentative de cette requête.


Signe une charge utile en utilisant la clé de signature disponible d'un émetteur et enregistre l'attestation résultante. La politique de l'émetteur, l'état de la clé, l'environnement et les limites d'utilisation peuvent empêcher la frappe.

## Choisir un type d'enregistrement

Pour un enregistrement structuré, choisissez `schema` dans le menu déroulant du type d'enregistrement et entrez un objet JSON dans `claims`. Laissez `payload_b64url` vide. Le serveur sérialise ces champs dans la charge utile JSON signée. Cela identifie le type d'enregistrement ; cela n'établit pas indépendamment que les revendications sont vraies.

## Choisir un pack de vérification

Les packs de vérification appartiennent à votre espace de travail. Utilisez le sélecteur ci-dessous avec le même environnement et la même clé API que Try it, puis copiez l'ID sélectionné dans `pack_id`. Omettez ce champ pour un enregistrement autonome. Vous pouvez également utiliser [Lister les packs de vérification](https://docs.truthlocks.com/fr/api-reference/verification-packs/list.md) ou [Mint dans Console](https://console.truthlocks.com/attestations/mint).

**Select a workspace verification pack**

This read-only lookup sends your key directly to the selected Truthlocks API. It keeps the key only in this componentâ€™s memory and does not mint a record.

API environment
Workspace API key

Clear key and results

Verification pack

## Utiliser une charge utile existante

Si vous avez déjà les octets exacts à signer, omettez `schema` et `claims`. Encodez les octets originaux en **base64url non paddé** dans `payload_b64url`. Pour JSON, sérialisez d'abord l'objet. Les champs d'application tels que `subject`, `claims` et `schema` appartiennent à ces octets encodés ; utilisez-les soit via l'entrée structurée ci-dessus, soit à l'intérieur des octets encodés, jamais les deux. Ce point de terminaison ne vérifie pas indépendamment la véracité des affirmations soumises ni ne valide des schémas d'informations d'identification arbitraires.

Utilisez le `kid` de la clé et le `alg` correspondant. L'enregistrement de la clé publique seule ne rend pas une clé de signature privée disponible. Voir [clés d'émetteur](https://docs.truthlocks.com/fr/api-reference/issuers/keys.md).

## Expiration facultative

Pour les `schema` et `claims` structurés, définissez `expires_at_unix` sur un horodatage Unix futur en **secondes**. Truthlocks l'inclut à la racine de la charge utile JSON signée. Avec `payload_b64url`, placez ce champ à l'intérieur de la charge utile JSON exacte avant de l'encoder et omettez le champ de requête séparé.

Après cet instant, la vérification renvoie `EXPIRED`. L'expiration ne peut pas être prolongée ou supprimée d'un enregistrement signé existant ; créez un remplacement. Omettez-la lorsque vous ne souhaitez pas d'expiration d'attestation. Les dates figurant dans les revendications individuelles, telles que le `expiry_date` d'un passeport, sont des revendications distinctes et ne définissent pas automatiquement l'expiration de l'attestation. Les enregistrements existants ne se voient pas attribuer de date rétroactivement.

Conservez la charge utile exacte et l'expiration lors de la nouvelle tentative. Une nouvelle tentative idempotente renvoie l'enregistrement original même après son expiration.

## Réessayer en toute sécurité

`Idempotency-Key` est requis. Générez une valeur par frappe prévue et conservez-la avec la demande originale pour les tentatives. Ne la réutilisez pas pour un contenu différent.

## Intégrité des documents

Le hachage du document stocké est sélectionné dans cet ordre :

1. `claims.document.sha256` à l'intérieur d'une charge utile JSON.
2. Le `document_hash` de la requête.
3. SHA-256 des octets de la charge utile décodée.

Un hachage intégré a priorité sur le champ séparé. Incluez le hachage dans la charge utile signée lorsque vous devez lier cette revendication à la signature. Un hachage soumis est une revendication concernant un fichier ; le serveur ne peut pas établir le contenu du fichier à partir du seul hachage.

Passez `document_hash_hex` à [vérification](https://docs.truthlocks.com/fr/api-reference/verify.md) pour comparer un hachage de fichier. Conservez la charge utile originale pour la vérification de l'intégrité de la charge utile.

## Réponse et livraison

HTTP 201 renvoie `attestation_id`, `issued_at_unix`, `signature` et `log`. La position du journal est `log.leaf_index`, et non un `log_index` de niveau supérieur.

`recipient_email` demande une notification asynchrone. HTTP 201 confirme la frappe, pas la livraison de l'e-mail. Omettez-le lorsque vous distribuez l'enregistrement vous-même.

Consultez le [guide de démarrage rapide](https://docs.truthlocks.com/fr/quickstart.md) pour une requête utilisant les champs d'entrée et de réponse réels.

## Guide des champs de type d'enregistrement

Ces champs sont des structures de revendication suggérées, et non une garantie de validation de revendication ou de vérification d'identité.

| ID de schéma | Nom | Catégorie | Champs de réclamation |
| - | - | - | - |
| `verifiable-id` | ID vérifiable | Identité | `full_name, employee_id, department, title, start_date` |
| `passport` | Passeport | Identité | `full_name, nationality, passport_number, date_of_birth, expiry_date, issuing_country` |
| `drivers-license` | Permis de conduire | Identité | `full_name, license_number, state, class, expiry_date, date_of_birth` |
| `government-id` | Pièce d'identité gouvernementale | Identité | `full_name, id_number, id_type, issuing_authority, country, expiry_date` |
| `self-sovereign-id` | ID auto-souverain | Identité | `did, display_name, created_at` |
| `employment-verification` | Vérification d'emploi | Emploi | `employee_name, employer, position, department, employment_type, start_date, end_date` |
| `professional-role` | Rôle professionnel | Emploi | `full_name, title, organization, department, effective_date` |
| `membership-card` | Carte de membre | Emploi | `member_name, organization, membership_id, tier, valid_from, valid_to` |
| `professional-certification` | Certification professionnelle | Emploi | `holder_name, certification_name, issuing_body, certification_id, issued_date, expiry_date` |
| `license` | Licence | Emploi | `holder_name, license_type, license_number, issuing_authority, jurisdiction, issued_date, expiry_date` |
| `accreditation` | Accréditation | Emploi | `entity_name, accreditation_body, standard, scope, valid_from, valid_to` |
| `degree` | Diplôme | Éducation | `student_name, institution, degree_type, field_of_study, graduation_date, honors` |
| `completion-cert` | Certificat de fin d'études | Éducation | `participant_name, program_name, institution, completion_date, hours` |
| `course-credit` | Crédit de cours | Éducation | `student_name, course_name, institution, credits, grade, semester` |
| `transcript` | Relevé de notes | Éducation | `student_name, institution, program, gpa, total_credits, issue_date` |
| `micro-credential` | Micro-accréditation | Éducation | `earner_name, credential_name, issuer, skills, earned_date` |
| `training-completion` | Achèvement de formation | Éducation | `trainee_name, training_program, provider, completion_date, score, certificate_id` |
| `medical-license` | Licence médicale | Santé | `practitioner_name, license_number, specialty, state, issued_date, expiry_date` |
| `dea-registration` | Enregistrement DEA | Santé | `registrant_name, dea_number, schedules, business_activity, expiry_date` |
| `board-certification` | Certification professionnelle | Santé | `physician_name, board, specialty, certification_date, expiry_date` |
| `health-credential` | Accréditation santé | Santé | `patient_name, credential_type, provider, date, details` |
| `vaccination-record` | Carnet de vaccination | Santé | `patient_name, vaccine_name, manufacturer, lot_number, date_administered, dose_number, site` |
| `aml-kyc` | Vérification AML/KYC | Conformité | `entity_name, check_type, result, risk_level, verified_by, verified_at` |
| `security-clearance` | Habilitation de sécurité | Conformité | `holder_name, clearance_level, granting_agency, granted_date, expiry_date` |
| `sam-gov` | Enregistrement SAM.gov | Conformité | `entity_name, cage_code, uei, registration_status, expiry_date` |
| `jurisdiction-approval` | Approbation de juridiction | Conformité | `entity_name, jurisdiction, approval_type, approved_date, conditions` |
| `attestation-of-will` | Attestation de testament | Conformité | `declarant_name, declaration, witness, date` |
| `bank-verification` | Vérification bancaire | Financier | `account_holder, bank_name, account_type, routing_number_last4, verified_date` |
| `credit-attestation` | Attestation de crédit | Finance | `entity_name, credit_score_range, reporting_agency, assessment_date` |
| `income-verification` | Vérification de revenus | Finance | `individual_name, employer, annual_income_range, verification_date, tax_year` |
| `skill-badge` | Badge de compétence | Compétences et formation | `earner_name, skill_name, proficiency_level, assessed_by, earned_date` |
| `competency` | Attestation de compétence | Compétences et formation | `individual_name, competency, level, assessor, assessment_date` |
| `industry-cert` | Certification industrielle | Compétences et formation | `holder_name, certification, issuing_body, cert_id, issued_date, expiry_date` |
| `product-authenticity` | Authenticité du produit | Chaîne d'approvisionnement | `product_name, sku, serial_number, manufacturer, manufactured_date, origin_country` |
| `chain-of-custody` | Chaîne de possession | Chaîne d'approvisionnement | `item_description, from_entity, to_entity, transfer_date, location, condition` |
| `origin-verification` | Vérification d'origine | Chaîne d'approvisionnement | `product_name, origin_country, origin_region, certifying_body, verified_date` |
| `custom` | Personnalisé | Autre | `subject, type, details` |
| `attestation` | Attestation générique | Autre | `subject, claim, evidence` |


## OpenAPI

````yaml fr/mint-openapi.yaml POST /v1/attestations/mint
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/attestations/mint:
    post:
      tags:
        - Attestations
      summary: Émettre une attestation
      description: >
        Émettez une attestation signée en utilisant un schéma structuré et des
        revendications, ou une charge utile encodée.

        Conservez la même clé d'idempotence et le même corps lors de la nouvelle
        tentative de cette requête.
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
          description: >-
            Conservez la même valeur et le même corps de requête lors de la
            nouvelle tentative d'une frappe.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              description: >-
                Choisissez Enregistrement structuré pour sélectionner un type
                d'enregistrement et saisir des revendications, ou Charge utile
                encodée pour signer des octets existants. Ne combinez jamais les
                deux formats d'entrée.
              oneOf:
                - title: Structured record
                  type: object
                  required:
                    - issuer_id
                    - kid
                    - alg
                    - schema
                    - claims
                  properties:
                    alg:
                      $ref: '#/components/schemas/SigningAlgorithm'
                      description: >-
                        Doit correspondre à la clé de signature de l'émetteur
                        sélectionnée.
                    attestation_id:
                      type: string
                    content_type:
                      type: string
                      description: >-
                        Type MIME des octets originaux, tel que
                        application/json, application/pdf ou image/png. L'entrée
                        de schéma/revendications structurée nécessite
                        application/json.
                      example: application/json
                    document_hash:
                      type: string
                      description: >-
                        Hachage SHA-256 hexadécimal optionnel du document. Un
                        claims.document.sha256 intégré a la priorité ; sinon, ce
                        champ est utilisé, puis le hachage de la charge utile
                        décodée.
                    issuer_id:
                      type: string
                      description: L'UUID de l'émetteur créant l'attestation
                      format: uuid
                      example: 550e8400-e29b-41d4-a716-446655440000
                    kid:
                      type: string
                      description: Identifiant de clé pour la clé de signature
                      example: es256-key-1
                    pack_id:
                      type: string
                      description: >-
                        UUID optionnel du pack de vérification de l'espace de
                        travail. Utilisez la liste des packs de vérification
                        avec la même clé API pour sélectionner un pack actif
                        existant ; omettez pour un enregistrement autonome.
                      format: uuid
                    expires_at_unix:
                      type: integer
                      format: int64
                      minimum: 1
                      maximum: 253402300799
                      description: >-
                        Horodatage Unix futur optionnel en secondes pour
                        l'entrée de schéma/revendications structuré. Il est
                        inclus dans la charge utile JSON signée. Pour l'entrée
                        payload_b64url, omettez ce champ de requête et intégrez
                        plutôt expires_at_unix à la racine de la charge utile
                        JSON exacte. L'expiration ne peut pas être modifiée sur
                        place.
                    recipient_email:
                      type: string
                      description: >-
                        Destinataire optionnel pour une notification asynchrone
                        après la frappe. Une réponse de frappe réussie ne
                        confirme pas la livraison.
                      format: email
                    schema:
                      type: string
                      description: >-
                        Type d'enregistrement pour l'entrée structurée.
                        Fournissez des revendications et omettez payload_b64url.
                        Cette étiquette ne valide pas indépendamment la véracité
                        des revendications.
                      enum:
                        - verifiable-id
                        - passport
                        - drivers-license
                        - government-id
                        - self-sovereign-id
                        - employment-verification
                        - professional-role
                        - membership-card
                        - professional-certification
                        - license
                        - accreditation
                        - degree
                        - completion-cert
                        - course-credit
                        - transcript
                        - micro-credential
                        - training-completion
                        - medical-license
                        - dea-registration
                        - board-certification
                        - health-credential
                        - vaccination-record
                        - aml-kyc
                        - security-clearance
                        - sam-gov
                        - jurisdiction-approval
                        - attestation-of-will
                        - bank-verification
                        - credit-attestation
                        - income-verification
                        - skill-badge
                        - competency
                        - industry-cert
                        - product-authenticity
                        - chain-of-custody
                        - origin-verification
                        - custom
                        - attestation
                      example: verifiable-id
                    claims:
                      type: object
                      additionalProperties: true
                      description: >-
                        Champs d'enregistrement structurés. Requis avec le
                        schéma ; ne peut pas être combiné avec payload_b64url.
                      example:
                        full_name: Example recipient
                        employee_id: QA-001
                - title: Encoded payload
                  type: object
                  required:
                    - issuer_id
                    - kid
                    - alg
                    - payload_b64url
                  properties:
                    alg:
                      $ref: '#/components/schemas/SigningAlgorithm'
                      description: >-
                        Doit correspondre à la clé de signature de l'émetteur
                        sélectionnée.
                    attestation_id:
                      type: string
                    content_type:
                      type: string
                      description: >-
                        Type MIME des octets originaux, tel que
                        application/json, application/pdf ou image/png. L'entrée
                        de schéma/revendications structurée nécessite
                        application/json.
                      example: application/json
                    document_hash:
                      type: string
                      description: >-
                        Hachage SHA-256 hexadécimal optionnel du document. Un
                        claims.document.sha256 intégré a la priorité ; sinon, ce
                        champ est utilisé, puis le hachage de la charge utile
                        décodée.
                    issuer_id:
                      type: string
                      description: L'UUID de l'émetteur créant l'attestation
                      format: uuid
                      example: 550e8400-e29b-41d4-a716-446655440000
                    kid:
                      type: string
                      description: Identifiant de clé pour la clé de signature
                      example: es256-key-1
                    pack_id:
                      type: string
                      description: >-
                        UUID optionnel du pack de vérification de l'espace de
                        travail. Utilisez la liste des packs de vérification
                        avec la même clé API pour sélectionner un pack actif
                        existant ; omettez pour un enregistrement autonome.
                      format: uuid
                    recipient_email:
                      type: string
                      description: >-
                        Destinataire optionnel pour une notification asynchrone
                        après la frappe. Une réponse de frappe réussie ne
                        confirme pas la livraison.
                      format: email
                    payload_b64url:
                      type: string
                      description: >-
                        Base64url non rempli des octets exacts à signer.
                        Utilisez ceci OU le schéma plus les revendications.
      responses:
        '201':
          description: Attestation émise
          content:
            application/json:
              schema:
                type: object
                properties:
                  attestation_id:
                    type: string
                    format: uuid
                  issuer_id:
                    type: string
                    format: uuid
                  version:
                    type: string
                  status:
                    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
                    format: int64
                  payload_hash:
                    type: string
                  signature:
                    type: object
                    properties:
                      alg:
                        type: string
                      kid:
                        type: string
                      value:
                        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
                  governance:
                    type: object
                    nullable: true
        '400':
          description: Requête invalide
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '413':
          description: Charge utile trop volumineuse
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                code: PAYLOAD_TOO_LARGE
                message: Request body exceeds maximum size of 1MB
                http_status: 413
        '429':
          description: Limite de débit ou quota dépassé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                code: RATE_LIMIT_EXCEEDED
                message: Rate limit exceeded
                http_status: 429
                retry_after_ms: 60000
      security:
        - APIKey: []
components:
  schemas:
    SigningAlgorithm:
      type: string
      enum:
        - Ed25519
        - ES256
        - ES384
        - ES512
        - RS256
        - RS384
        - RS512
        - PS256
        - PS384
        - PS512
      description: Algorithme de signature pour la génération de clés
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Code d'erreur lisible par machine
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Message d'erreur lisible par l'homme
        http_status:
          type: integer
          description: Code de statut HTTP
        retry_after_ms:
          type: integer
          description: >-
            Millisecondes à attendre avant de réessayer (pour les limites de
            débit)
        details:
          type: object
          description: Contexte d'erreur supplémentaire
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  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.