> ## 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 incorporáveis

> Adicione selos de verificação ao seu site, README ou portfólio para provar a autenticidade do conteúdo.

Depois de proteger o conteúdo no Truthlocks, você pode incorporar um selo que se vincula à prova criptográfica. Os visitantes clicam no selo para verificar a autenticidade sem precisar de uma conta Truthlocks.

## Como os selos funcionam

Cada proteção gera uma URL de selo única e uma URL de página de prova. O selo é uma imagem SVG dinâmica que mostra o status de verificação atual — **Protegido** (ciano/verde) ou **Não Encontrado** (vermelho). Clicar no selo abre a página de prova onde qualquer pessoa pode inspecionar os detalhes do atestado.

Formato da URL do selo:

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

Formato da URL da página de prova:

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

## Estilos de selo

Os selos estão disponíveis em quatro estilos. Anexe o parâmetro de consulta `style` para escolher um layout:

| Estilo | Descrição | Tamanho |
| :- | :- | :- |
| **padrão** | Crachá de escudo de dois tons com sobreposição de gradiente e cantos arredondados | 300 × 36 px |
| **plano** | Mesmo layout de dois tons sem gradientes — limpo e minimalista | 300 × 36 px |
| **grande** | Crachá estilo cartão mostrando pílula de status, título do conteúdo e data de proteção | 400 × 80 px |
| **minimalista** | Rótulo de marca de seleção somente texto sem fundo | 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 tema escuro

Cada estilo suporta uma variante de tema escuro. Anexe `theme=dark` para usar fundos mais claros e cores de destaque mais brilhantes, adequadas para páginas de fundo escuro:

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

> [!TIP]
>
> Use o estilo `large` em páginas de destino onde você deseja destacar a data de proteção e o título do conteúdo. Use `minimal` para texto em linha ou rodapés de README onde o espaço é limitado.

## Formatos de incorporação

Após proteger o conteúdo, copie o código de incorporação do selo da página de prova ou da tela de sucesso. A Truthlocks oferece dois formatos:

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

Substitua `ATTESTATION_ID` pelo ID devolvido quando cunhou a proteção. Para usar um estilo específico, adicione `?style=flat` (ou qualquer nome de estilo) ao URL do emblema. Adicione `&theme=dark` para páginas escuras.

> [!TIP]
>
> Na página Proteger, clique em **Copiar Selo** após proteger o conteúdo para copiar o
> Código de incorporação Markdown para sua área de transferência.

## Status dinâmico

Os selos refletem o status de verificação em tempo real do atestado subjacente:

| Status | Aparência | Significado |
| - | - | - |
| **Protegido** | Crachá ciano/verde | O atestado existe e é válido no log de transparência |
| **Não Encontrado** | Crachá vermelho | O atestado não foi encontrado ou foi revogado |

As respostas dos selos são armazenadas em cache por até uma hora. Se você revogar um atestado, o selo será atualizado para "Não Encontrado" após a expiração do cache.

## Certificados

Você pode baixar um certificado SVG formal para qualquer proteção. O certificado redesenhado apresenta um layout premium com um cabeçalho de gradiente escuro, selo de verificação circular, ornamentos de canto e um cartão de detalhes mostrando a categoria, data, ID de atestado, emissor e hash de conteúdo SHA-256.

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

A versão SVG é baixada como um arquivo (`truthlocks-certificate-{id}.svg`). A versão HTML renderiza o certificado em um layout de página centralizado adequado para impressão ou incorporação.

Os certificados são úteis para evidências legais, exibições de portfólio ou impressão. Faça o download na página de prova ou na tela de sucesso da proteção.

## Onde usar selos

* **READMEs do GitHub** — prove a autoria de código-fonte aberto
* **Sites pessoais** — mostre aos visitantes que seu conteúdo é verificado
* **Páginas de portfólio** — vincule cada peça à sua prova criptográfica
* **Bios de mídia social** — compartilhe diretamente o URL da sua página de prova

## Próximos passos

> [card] [Proteção de conteúdo](https://docs.truthlocks.com/guides/content-protection.md)
>
> Guia completo para proteger conteúdo com atestações criptográficas.

> [card] [Portfólio público](https://docs.truthlocks.com/guides/portfolio.md)
>
> Mostre seu conteúdo protegido em uma página de perfil público.

> [card] [Especificação do pacote de prova](https://docs.truthlocks.com/specification/proof-bundle.md)
>
> Especificação técnica para o payload de verificação por trás de cada selo.


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