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

# Obtener Código QR

Genera una imagen de código QR para una atestación. El código QR codifica la URL de verificación completa que cualquiera puede escanear para verificar la atestación de forma independiente.

### Casos de uso

* Imprimir en certificados, insignias y documentos
* Incrustar en correos electrónicos o páginas de prueba digitales
* Mostrar en pantallas para verificación móvil instantánea

### Respuesta

Devuelve una imagen PNG con `Content-Type: image/png`.

La respuesta incluye encabezados de caché agresivos (`Cache-Control: public, max-age=31536000, immutable`) ya que los códigos QR para una atestación dada nunca cambian.

### Formato de URL codificada

El código QR codifica:

```
https://verify.truthlocks.com/proof/{attestation_id}
```

Cualquiera que escanee este código QR será llevado directamente a la página de verificación de esta atestación.

```bash cURL theme={null}
curl -H "Authorization: Bearer $API_KEY" \
  "https://api.truthlocks.com/v1/attestations/550e8400-e29b-41d4-a716-446655440000/qr?size=512" \
  --output attestation-qr.png
```

```typescript SDK theme={null}
const qrImage = await client.attestations.getQRCode(attestationId, { size: 512 });
fs.writeFileSync('attestation-qr.png', Buffer.from(qrImage));
```


## OpenAPI

````yaml es/mint-openapi.yaml GET /v1/attestations/{id}/qr
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks es una infraestructura de verificación universal para documentos,
    credenciales y activos digitales.

    Esta especificación define la API canónica para interactuar con los
    servicios de Truthlocks.


    ## URLs Base

    - **Producción**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Autenticación

    - **Claves API**: Use el encabezado `X-API-Key` para operaciones máquina a
    máquina

    - **Tokens Bearer**: Use `Authorization: Bearer <jwt>` para operaciones
    iniciadas por el usuario


    ## Identidad del Inquilino

    En producción, la identidad del inquilino se deriva del contexto autenticado
    (clave API o JWT).

    El encabezado `X-Tenant-ID` se ignora en producción para evitar la
    suplantación de identidad.
  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 producción
  - url: https://sandbox-api.truthlocks.com
    description: Entorno Sandbox
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestión de claves y tokens de API
  - name: Issuers
    description: Registro del emisor y gestión de la confianza
  - name: Keys
    description: Gestión de claves criptográficas para emisores
  - name: Attestations
    description: Ciclo de vida de la atestación (acuñar, revocar, reemplazar)
  - name: Verification
    description: Verificación de atestación y paquetes de prueba
  - name: Governance
    description: Flujos de trabajo de gobernanza del emisor (solo administrador)
  - name: Identity
    description: Gestión de organización, usuarios y roles
  - name: Audit
    description: Consultas de eventos de auditoría
  - name: Tenant Console
    description: Puntos finales de perfil y ciclo de vida del inquilino
  - name: Health
    description: Endpoints de estado y preparación del servicio
  - name: Risk
    description: Ingesta de señales de riesgo y detección de fraude
  - name: Risk Enforcement
    description: >-
      Acciones de aplicación de riesgos: bloqueo, desafío, cuarentena y
      configuración
  - name: Billing
    description: Gestión de facturación, suscripciones y complementos
  - name: Machine Identity
    description: >-
      Protocolo de Identidad de Agente de Máquina (MAIP) — registro de agentes,
      sesiones, confianza, testigo, cumplimiento, orquestación y observabilidad
externalDocs:
  description: API de transparencia de solo lectura (especificación de servicio separada)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/attestations/{id}/qr:
    get:
      tags:
        - Attestations
      summary: Generar imagen QR
      operationId: GET__v1_attestations__id__qr
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: ID propiedad de su espacio de trabajo.
        - name: size
          in: query
          required: false
          schema:
            type: integer
            minimum: 128
            maximum: 1024
            default: 256
      responses:
        '200':
          description: >-
            Imagen PNG. La generación de un código no establece que exista un
            registro o que pase la verificación.
          content:
            image/png:
              schema:
                type: string
                format: binary
        '401':
          description: Credenciales faltantes o inválidas.
        '403':
          description: Acceso denegado para este espacio de trabajo, entorno o plan.
      security:
        - APIKey: []
        - BearerAuth: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clave API para autenticación máquina a máquina
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT para operaciones iniciadas por el usuario

````

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