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

# Einbettbare Badges

> Fügen Sie Verifizierungsabzeichen zu Ihrer Website, README oder Ihrem Portfolio hinzu, um die Authentizität des Inhalts zu beweisen.

Nachdem Sie Inhalte auf Truthlocks geschützt haben, können Sie ein Abzeichen einbetten, das auf den kryptografischen Nachweis verweist. Besucher klicken auf das Abzeichen, um die Authentizität zu überprüfen, ohne ein Truthlocks-Konto zu benötigen.

## Wie Badges funktionieren

Jeder Schutz generiert eine eindeutige Badge-URL und eine Nachweisseiten-URL. Das Badge ist ein dynamisches SVG-Bild, das den aktuellen Verifizierungsstatus anzeigt – **Geschützt** (Cyan/Grün) oder **Nicht gefunden** (Rot). Durch Klicken auf das Badge wird die Nachweisseite geöffnet, auf der jeder die Bestätigungsdetails einsehen kann.

Badge-URL-Format:

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

URL-Format der Proof-Seite:

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

## Badge-Stile

Badges sind in vier Stilen erhältlich. Fügen Sie den Abfrageparameter `style` hinzu, um ein Layout auszuwählen:

| Stil | Beschreibung | Größe |
| :- | :- | :- |
| **default** | Zweifarbiges Schild-Badge mit Farbverlauf und abgerundeten Ecken | 300 × 36 px |
| **flat** | Gleiches zweifarbiges Layout ohne Farbverläufe – sauber und minimalistisch | 300 × 36 px |
| **large** | Badge im Kartenstil mit Status-Pill, Inhaltstitel und Schutzdatum | 400 × 80 px |
| **minimal** | Nur-Text-Häkchen-Label ohne Hintergrund | 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
```

### Dunkles Theme

Jeder Stil unterstützt eine dunkle Theme-Variante. Fügen Sie `theme=dark` an, um hellere Hintergründe und hellere Akzentfarben zu verwenden, die für Seiten mit dunklem Hintergrund geeignet sind:

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

> [!TIP]
>
> Verwenden Sie den Stil `large` auf Landing Pages, wo Sie das Schutzdatum und den Inhaltstitel hervorheben möchten. Verwenden Sie `minimal` für Inline-Text oder README-Fußzeilen, wo der Platz begrenzt ist.

## Einbettungsformate

Nachdem Sie Inhalte geschützt haben, kopieren Sie den Badge-Einbettungscode von der Proof-Seite oder dem Erfolgsbildschirm. Truthlocks bietet zwei Formate:

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

Ersetzen Sie `ATTESTATION_ID` durch die ID, die Sie beim Prägen des Schutzes erhalten haben. Um einen bestimmten Stil zu verwenden, fügen Sie `?style=flat` (oder einen beliebigen Stilnamen) zur Badge-URL hinzu. Fügen Sie `&theme=dark` für dunkle Seiten hinzu.

> [!TIP]
>
> Klicken Sie auf der Seite „Schützen“ nach dem Schutz von Inhalten auf **Abzeichen kopieren**, um das
> Markdown-Einbettungscode in Ihre Zwischenablage.

## Dynamischer Status

Badges spiegeln den Echtzeit-Verifizierungsstatus der zugrunde liegenden Bestätigung wider:

| Status | Aussehen | Bedeutung |
| - | - | - |
| **Geschützt** | Cyan/grünes Abzeichen | Die Bestätigung existiert und ist im Transparenzprotokoll gültig |
| **Nicht gefunden** | Rotes Abzeichen | Die Bestätigung wurde nicht gefunden oder widerrufen |

Badge-Antworten werden bis zu einer Stunde lang zwischengespeichert. Wenn Sie eine Bestätigung widerrufen, wird das Badge nach Ablauf des Caches auf „Nicht gefunden“ aktualisiert.

## Zertifikate

Sie können ein formelles SVG-Zertifikat für jeden Schutz herunterladen. Das neu gestaltete Zertifikat verfügt über ein Premium-Layout mit einem dunklen Verlaufsheader, einem kreisförmigen Verifizierungssiegel, Eckverzierungen und einer Detailkarte, die Kategorie, Datum, Attestierungs-ID, Aussteller und SHA-256-Inhalts-Hash anzeigt.

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

Die SVG-Version wird als Datei (`truthlocks-certificate-{id}.svg`) heruntergeladen. Die HTML-Version rendert das Zertifikat in einem zentrierten Seitenlayout, das zum Drucken oder Einbetten geeignet ist.

Zertifikate sind nützlich für rechtliche Nachweise, Portfolio-Anzeigen oder den Druck. Laden Sie sie von der Nachweisseite oder dem Bildschirm für den Schutz-Erfolg herunter.

## Wo Abzeichen verwendet werden sollten

* **GitHub READMEs** – beweisen Sie die Urheberschaft von Open-Source-Code
* **Persönliche Websites** – zeigen Besuchern, dass Ihre Inhalte verifiziert sind
* **Portfolio-Seiten** – verknüpfen Sie jedes Stück mit seinem kryptografischen Nachweis
* **Social-Media-Biografien** – teilen Sie Ihre Proof-Seiten-URL direkt

## Nächste Schritte

> [card] [Inhaltsschutz](https://docs.truthlocks.com/guides/content-protection.md)
>
> Vollständige Anleitung zum Schutz von Inhalten mit kryptografischen Bestätigungen.

> [card] [Öffentliches Portfolio](https://docs.truthlocks.com/guides/portfolio.md)
>
> Präsentieren Sie Ihre geschützten Inhalte auf einer öffentlichen Profilseite.

> [card] [Proof-Bundle-Spezifikation](https://docs.truthlocks.com/specification/proof-bundle.md)
>
> Technische Spezifikation für die Verifizierungs-Payload hinter jedem Badge.


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