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

# Inhalt schützen (Consumer Mint)

> Prägen Sie eine kryptografische Attestierung für Inhalte, die Sie schützen möchten. Ihr persönlicher Aussteller und Signaturschlüssel werden automatisch aufgelöst. Hashen Sie den Inhalt clientseitig (SHA-256) und übermitteln Sie den Hash mit den Dateimetadaten.

Prägen Sie eine kryptografische Attestierung für einen Inhalt, den Sie schützen möchten. Ihr persönlicher Aussteller und Signaturschlüssel werden automatisch aufgelöst – Sie müssen keinen Aussteller erstellen oder einen Schlüssel registrieren.

Hashen Sie Ihren Inhalt clientseitig mit SHA-256 und übermitteln Sie den Hash zusammen mit den Dateimetadaten. Der Endpunkt gibt einen Schutzdatensatz mit einer teilbaren Nachweis-URL zurück, die Sie verwenden können, um die Urheberschaft zu demonstrieren.

Ratenlimits hängen von Ihrer Planstufe ab:

| Plan | Schutz pro Monat |
| - | - |
| Kostenlos | 50 |
| Ersteller | 500 |
| Pro | Planabhängig |

Die Antwort enthält `content_hash` und `protected_at`, damit Sie bestätigen können, welcher Inhalt geschützt wurde und den genauen Zeitstempel, ohne einen Folgeanruf tätigen zu müssen.

### Antworten


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/consumer/mint
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

    - **Produktion**: `https://api.truthlocks.com`

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


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/consumer/mint:
    post:
      tags:
        - Consumer
      summary: Inhalt schützen (Consumer Mint)
      description: >-
        Prägen Sie eine kryptografische Attestierung für Inhalte, die Sie
        schützen möchten. Ihr persönlicher Aussteller und Signaturschlüssel
        werden automatisch aufgelöst. Hashen Sie den Inhalt clientseitig
        (SHA-256) und übermitteln Sie den Hash mit den Dateimetadaten.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - content_hash
              properties:
                content_hash:
                  type: string
                  description: SHA-256-Hash des Dateiinhalts, clientseitig berechnet.
                title:
                  type: string
                  description: Menschenlesbarer Titel für den Schutz.
                description:
                  type: string
                  description: Optionale Beschreibung des geschützten Inhalts.
                content_type:
                  type: string
                  description: MIME-Typ des Inhalts (z.B. image/png).
                file_name:
                  type: string
                  description: Originaler Dateiname einschließlich Erweiterung.
                file_size:
                  type: integer
                  description: Dateigröße in Bytes.
                category:
                  type: string
                  enum:
                    - code
                    - research
                    - design
                    - media
                    - dataset
                    - ai-output
                    - writing
                    - digital-art
                    - other
                  description: Inhaltskategorie. Standardmäßig „Sonstiges“.
                ai_metadata:
                  type: object
                  description: Optionales, KI-extrahiertes Metadatenobjekt.
                visibility:
                  type: string
                  enum:
                    - public
                    - private
                  description: >-
                    Ob der Schutz in Ihrem öffentlichen Portfolio erscheint.
                    Standardmäßig privat.
      responses:
        '201':
          description: Inhalt geschützt
          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: SHA-256-Hash, der von der Anfrage zurückgegeben wird.
                  protected_at:
                    type: string
                    format: date-time
                    description: Zeitstempel, wann der Inhalt geschützt wurde (RFC 3339).
                  status:
                    type: string
                    enum:
                      - protected
        '400':
          description: Erforderliches Feld fehlt
        '401':
          description: Nicht autorisiert
        '429':
          description: Monatliches Schutzlimit erreicht
      security:
        - BearerAuth: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

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