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

# Insignias incrustables

> Agregue insignias de verificación a su sitio web, README o portafolio para probar la autenticidad del contenido.

Después de proteger el contenido en Truthlocks, puede incrustar una insignia que enlace a la prueba criptográfica. Los visitantes hacen clic en la insignia para verificar la autenticidad sin necesidad de una cuenta de Truthlocks.

## Cómo funcionan las insignias

Cada protección genera una URL de insignia única y una URL de página de prueba. La insignia es una imagen SVG dinámica que muestra el estado de verificación actual — **Protegido** (cian/verde) o **No encontrado** (rojo). Al hacer clic en la insignia se abre la página de prueba donde cualquiera puede inspeccionar los detalles de la atestación.

Formato de URL de insignia:

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

Formato de URL de la página de prueba:

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

## Estilos de insignias

Las insignias están disponibles en cuatro estilos. Agregue el parámetro de consulta `style` para elegir un diseño:

| Estilo | Descripción | Tamaño |
| :- | :- | :- |
| **predeterminado** | Insignia de escudo de dos tonos con una superposición de degradado y esquinas redondeadas | 300 × 36 px |
| **plano** | Mismo diseño de dos tonos sin degradados — limpio y minimalista | 300 × 36 px |
| **grande** | Insignia estilo tarjeta que muestra la píldora de estado, el título del contenido y la fecha de protección | 400 × 80 px |
| **minimalista** | Etiqueta de marca de verificación solo de texto sin fondo | 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 oscuro

Cada estilo admite una variante de tema oscuro. Agregue `theme=dark` para usar fondos más claros y colores de acento más brillantes adecuados para páginas con fondo oscuro:

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

> [!TIP]
>
> Utilice el estilo `large` en las páginas de destino donde desee resaltar la fecha de protección y el título del contenido. Utilice `minimal` para texto en línea o pies de página de README donde el espacio sea limitado.

## Formatos de incrustación

Después de proteger el contenido, copie el código de inserción de la insignia de la página de prueba o de la pantalla de éxito. Truthlocks proporciona dos 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>
```

Reemplace `ATTESTATION_ID` con la ID devuelta cuando acuñó la protección. Para usar un estilo específico, agregue `?style=flat` (o cualquier nombre de estilo) a la URL de la insignia. Agregue `&theme=dark` para páginas oscuras.

> [!TIP]
>
> En la página Proteger, haga clic en **Copiar Insignia** después de proteger el contenido para copiar el
> Código de inserción Markdown en su portapapeles.

## Estado dinámico

Las insignias reflejan el estado de verificación en tiempo real de la atestación subyacente:

| Estado | Apariencia | Significado |
| - | - | - |
| **Protegido** | Insignia cian/verde | La atestación existe y es válida en el registro de transparencia |
| **No encontrado** | Insignia roja | La atestación no se encontró o ha sido revocada |

Las respuestas de las insignias se almacenan en caché hasta por una hora. Si revoca una atestación, la insignia se actualiza a "No encontrada" después de que expire la caché.

## Certificados

Puede descargar un certificado SVG formal para cualquier protección. El certificado rediseñado presenta un diseño premium con un encabezado de degradado oscuro, un sello de verificación circular, adornos en las esquinas y una tarjeta de detalles que muestra la categoría, la fecha, el ID de atestación, el emisor y el hash de contenido SHA-256.

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

La versión SVG se descarga como un archivo (`truthlocks-certificate-{id}.svg`). La versión HTML renderiza el certificado en un diseño de página centrado adecuado para imprimir o incrustar.

Los certificados son útiles como evidencia legal, para exhibiciones de portafolios o para imprimir. Descárguelos desde la página de prueba o la pantalla de éxito de protección.

## Dónde usar insignias

* **READMEs de GitHub** — pruebe la autoría de código de código abierto
* **Sitios web personales** — muestre a los visitantes que su contenido está verificado
* **Páginas de portafolio** — enlace cada pieza a su prueba criptográfica
* **Biografías de redes sociales** — comparta directamente la URL de su página de prueba

## Próximos pasos

> [card] [Protección de contenido](https://docs.truthlocks.com/guides/content-protection.md)
>
> Guía completa para proteger contenido con atestaciones criptográficas.

> [card] [Portafolio público](https://docs.truthlocks.com/guides/portfolio.md)
>
> Muestre su contenido protegido en una página de perfil público.

> [card] [Especificación del paquete de prueba](https://docs.truthlocks.com/specification/proof-bundle.md)
>
> Especificación técnica para la carga útil de verificación detrás de cada insignia.


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