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

# Proteger contenido (Consumer Mint)

> Acuñe una atestación criptográfica para el contenido que desea proteger. Su emisor personal y clave de firma se resuelven automáticamente. Hashing el contenido del lado del cliente (SHA-256) y envíe el hash con los metadatos del archivo.

Acuñe una atestación criptográfica para un contenido que desee proteger. Su emisor personal y clave de firma se resuelven automáticamente; no necesita crear un emisor ni registrar una clave.

Haga un hash de su contenido en el lado del cliente con SHA-256 y envíe el hash junto con los metadatos del archivo. El endpoint devuelve un registro de protección con una URL de prueba compartible que puede usar para demostrar la autoría.

Los límites de velocidad dependen del nivel de su plan:

| Plan | Protecciones por mes |
| - | - |
| Gratuito | 50 |
| Creador | 500 |
| Pro | Dependiente del plan |

La respuesta incluye `content_hash` y `protected_at` para que pueda confirmar qué contenido fue protegido y la marca de tiempo exacta sin realizar una llamada de seguimiento.

### Respuestas


## OpenAPI

````yaml es/mint-openapi.yaml POST /v1/consumer/mint
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/consumer/mint:
    post:
      tags:
        - Consumer
      summary: Proteger contenido (Consumer Mint)
      description: >-
        Acuñe una atestación criptográfica para el contenido que desea proteger.
        Su emisor personal y clave de firma se resuelven automáticamente.
        Hashing el contenido del lado del cliente (SHA-256) y envíe el hash con
        los metadatos del archivo.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - content_hash
              properties:
                content_hash:
                  type: string
                  description: >-
                    Hash SHA-256 del contenido del archivo, calculado en el lado
                    del cliente.
                title:
                  type: string
                  description: Título legible por humanos para la protección.
                description:
                  type: string
                  description: Descripción opcional del contenido protegido.
                content_type:
                  type: string
                  description: Tipo MIME del contenido (por ejemplo, image/png).
                file_name:
                  type: string
                  description: Nombre de archivo original incluyendo la extensión.
                file_size:
                  type: integer
                  description: Tamaño del archivo en bytes.
                category:
                  type: string
                  enum:
                    - code
                    - research
                    - design
                    - media
                    - dataset
                    - ai-output
                    - writing
                    - digital-art
                    - other
                  description: Categoría de contenido. Por defecto es 'otro'.
                ai_metadata:
                  type: object
                  description: Objeto de metadatos extraídos por IA opcional.
                visibility:
                  type: string
                  enum:
                    - public
                    - private
                  description: >-
                    Si la protección aparece en su cartera pública. Por defecto
                    es privada.
      responses:
        '201':
          description: Contenido protegido
          content:
            application/json:
              schema:
                type: object
                properties:
                  protection_id:
                    type: string
                    format: uuid
                  attestation_id:
                    type: string
                    format: uuid
                  verify_url:
                    type: string
                    format: uri
                  share_url:
                    type: string
                    format: uri
                  content_hash:
                    type: string
                    description: Hash SHA-256 devuelto de la solicitud.
                  protected_at:
                    type: string
                    format: date-time
                    description: >-
                      Marca de tiempo en que se protegió el contenido (RFC
                      3339).
                  status:
                    type: string
                    enum:
                      - protected
        '400':
          description: Campo requerido faltante
        '401':
          description: No autorizado
        '429':
          description: Límite de protección mensual alcanzado
      security:
        - 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.