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

# Badges intégrables

> Ajoutez des badges de vérification à votre site web, README ou portfolio pour prouver l'authenticité du contenu.

Après avoir protégé du contenu sur Truthlocks, vous pouvez intégrer un badge qui renvoie à la preuve cryptographique. Les visiteurs cliquent sur le badge pour vérifier l'authenticité sans avoir besoin d'un compte Truthlocks.

## Comment fonctionnent les badges

Chaque protection génère une URL de badge unique et une URL de page de preuve. Le badge est une image SVG dynamique qui affiche le statut de vérification actuel — **Protégé** (cyan/vert) ou **Non trouvé** (rouge). Cliquer sur le badge ouvre la page de preuve où n'importe qui peut inspecter les détails de l'attestation.

Format de l'URL du badge :

```text theme={null}
https://verify.truthlocks.com/api/badge/{attestation_id}
```

Format de l'URL de la page de preuve :

```text theme={null}
https://verify.truthlocks.com/proof/{attestation_id}
```

## Styles de badge

Les badges sont disponibles en quatre styles. Ajoutez le paramètre de requête `style` pour choisir une mise en page :

| Style | Description | Taille |
| :- | :- | :- |
| **default** | Badge bouclier bicolore avec un dégradé et des coins arrondis | 300 × 36 px |
| **flat** | Même disposition bicolore sans dégradés — propre et minimal | 300 × 36 px |
| **large** | Badge de style carte affichant la pilule de statut, le titre du contenu et la date de protection | 400 × 80 px |
| **minimal** | Étiquette de coche uniquement textuelle sans arrière-plan | 200 × 24 px |

```text theme={null}
https://verify.truthlocks.com/api/badge/{attestation_id}?style=default
https://verify.truthlocks.com/api/badge/{attestation_id}?style=flat
https://verify.truthlocks.com/api/badge/{attestation_id}?style=large
https://verify.truthlocks.com/api/badge/{attestation_id}?style=minimal
```

### Variante de thème sombre

Chaque style prend en charge une variante de thème sombre. Ajoutez `theme=dark` pour utiliser des arrière-plans plus clairs et des couleurs d'accentuation plus vives adaptées aux pages à fond sombre :

```text theme={null}
https://verify.truthlocks.com/api/badge/{attestation_id}?style=flat&theme=dark
```

> [!TIP]
>
> Utilisez le style `large` sur les pages de destination où vous souhaitez mettre en évidence la date de protection et le titre du contenu. Utilisez `minimal` pour le texte en ligne ou les pieds de page README où l'espace est limité.

## Formats d'intégration

Après avoir protégé le contenu, copiez le code d'intégration du badge depuis la page de preuve ou l'écran de succès. Truthlocks fournit deux formats :

```md Markdown theme={null}
[![Protected by Truthlocks](https://verify.truthlocks.com/api/badge/ATTESTATION_ID)](https://verify.truthlocks.com/proof/ATTESTATION_ID)
```

```html HTML theme={null}
<a href="https://verify.truthlocks.com/proof/ATTESTATION_ID">
  <img
    src="https://verify.truthlocks.com/api/badge/ATTESTATION_ID"
    alt="Protected by Truthlocks"
  />
</a>
```

Remplacez `ATTESTATION_ID` par l'ID renvoyé lors de la création de la protection. Pour utiliser un style spécifique, ajoutez `?style=flat` (ou tout nom de style) à l'URL du badge. Ajoutez `&theme=dark` pour les pages sombres.

> [!TIP]
>
> Sur la page Protéger, cliquez sur **Copier le badge** après avoir protégé le contenu pour copier le
> Code d'intégration Markdown dans votre presse-papiers.

## Statut dynamique

Les badges reflètent l'état de vérification en temps réel de l'attestation sous-jacente :

| Statut | Apparence | Signification |
| - | - | - |
| **Protégé** | Badge cyan/vert | L'attestation existe et est valide sur le journal de transparence |
| **Non trouvé** | Badge rouge | L'attestation n'a pas été trouvée ou a été révoquée |

Les réponses des badges sont mises en cache pendant une heure maximum. Si vous révoquez une attestation, le badge passe à "Non trouvé" après l'expiration du cache.

## Certificats

Vous pouvez télécharger un certificat SVG formel pour toute protection. Le certificat repensé présente une mise en page premium avec un en-tête à dégradé foncé, un sceau de vérification circulaire, des ornements d'angle et une carte de détails affichant la catégorie, la date, l'ID d'attestation, l'émetteur et le hachage de contenu SHA-256.

```text theme={null}
GET /api/certificate/{attestation_id}              → SVG download
GET /api/certificate/{attestation_id}?format=html  → HTML view
```

La version SVG se télécharge sous forme de fichier (`truthlocks-certificate-{id}.svg`). La version HTML affiche le certificat dans une mise en page centrée, adaptée à l'impression ou à l'intégration.

Les certificats sont utiles pour les preuves légales, les affichages de portefeuille ou l'impression. Téléchargez-les depuis la page de preuve ou l'écran de succès de la protection.

## Où utiliser les badges

* **READMEs GitHub** — prouver la paternité du code open-source
* **Sites web personnels** — montrez aux visiteurs que votre contenu est vérifié
* **Pages de portfolio** — liez chaque pièce à sa preuve cryptographique
* **Bios de médias sociaux** — partagez directement l'URL de votre page de preuve

## Prochaines étapes

> [card] [Protection du contenu](https://docs.truthlocks.com/guides/content-protection.md)
>
> Guide complet pour protéger le contenu avec des attestations cryptographiques.

> [card] [Portefeuille public](https://docs.truthlocks.com/guides/portfolio.md)
>
> Présentez votre contenu protégé sur une page de profil public.

> [card] [Spécification du paquet de preuves](https://docs.truthlocks.com/specification/proof-bundle.md)
>
> Spécification technique de la charge utile de vérification derrière chaque badge.


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