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

# Inhaltsähnlichkeitsprüfung

> Überprüfen Sie, ob ein Inhalts-Hash bereits bestehende öffentliche Schutzmaßnahmen aufweist.

GET
`/v1/consumer/similarity`

Überprüfen Sie, ob ein SHA-256-Inhalts-Hash bereits öffentliche Schutzmaßnahmen aufweist. Dies erkennt exakte öffentliche Hash-Übereinstimmungen; es führt keine perzeptuelle oder semantische Ähnlichkeitsanalyse durch oder stellt das Urheberrecht fest.

Senden Sie eine authentifizierte Sitzung unter Verwendung der in „Ausprobieren“ gezeigten Autorisierung. Schutzmaßnahmen, die zu Ihrem Arbeitsbereich gehören, sind ausgeschlossen. Der erforderliche Abfrageparameter `hash` ist der SHA-256-Digest, den Sie vergleichen möchten.

Es werden nur Schutzmaßnahmen mit `visibility: "public"` durchsucht. Private Schutzmaßnahmen werden niemals zurückgegeben.

### Antworten

### Antwortfelder

| Feld | Typ | Beschreibung |
| - | - | - |
| `content_hash` | string | Der von Ihnen übermittelte Hash, zur Bestätigung zurückgegeben. |
| `exact_match` | boolean | `true`, wenn mindestens ein öffentlicher Schutz für diesen Hash existiert. |
| `matches` | array | Bis zu 10 passende Schutzmaßnahmen, sortiert nach Erstellungsdatum. |
| `matches[].attestation_id` | string | Bestätigungs-ID des passenden Schutzes. |
| `matches[].title` | string | Titel des passenden Schutzes. |
| `matches[].category` | string | Inhaltskategorie (z.B. `photography`, `code`, `design`). |
| `matches[].similarity_score` | number | Immer `1.0` für exakte Hash-Übereinstimmungen. |
| `matches[].protected_at` | string | ISO 8601 Zeitstempel, wann der Inhalt geschützt wurde. |
| `total` | integer | Anzahl der zurückgegebenen Übereinstimmungen, keine unbegrenzte Gesamtzahl. |


## OpenAPI

````yaml de/mint-openapi.yaml GET /v1/consumer/similarity
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/similarity:
    get:
      tags:
        - Consumer
      summary: Genaue öffentliche Hash-Übereinstimmungen finden
      description: >-
        Suchen Sie öffentliche Schutzmaßnahmen nach exaktem Inhalts-Hash. Dies
        führt keine semantische oder perzeptuelle Ähnlichkeitsanalyse durch,
        stellt kein Urheberrecht fest oder durchsucht private Aufzeichnungen.
        Ergebnisse, die zum authentifizierten Arbeitsbereich gehören, werden
        ausgeschlossen.
      operationId: consumer.similarity
      parameters:
        - in: query
          name: hash
          required: true
          description: SHA-256-Inhalts-Digest zum Vergleich, als hexadezimaler Text.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Bis zu zehn übereinstimmende öffentliche Datensätze, ausgenommen
            dieser Arbeitsbereich.
          content:
            application/json:
              schema:
                type: object
                properties:
                  content_hash:
                    type: string
                  exact_match:
                    type: boolean
                  total:
                    type: integer
                    description: >-
                      Anzahl der zurückgegebenen Datensätze, keine unbegrenzte
                      Gesamtzahl.
                  matches:
                    type: array
                    items:
                      type: object
                      properties:
                        attestation_id:
                          type: string
                        title:
                          type: string
                        category:
                          type: string
                        similarity_score:
                          type: number
                          enum:
                            - 1
                        protected_at:
                          type: string
                          format: date-time
        '400':
          description: Erforderlicher Hash fehlt
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - BearerAuth: []
components:
  schemas:
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Maschinenlesbarer Fehlercode
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Menschenlesbare Fehlermeldung
        http_status:
          type: integer
          description: HTTP-Statuscode
        retry_after_ms:
          type: integer
          description: >-
            Millisekunden, die vor einem erneuten Versuch gewartet werden sollen
            (für Ratenbegrenzungen)
        details:
          type: object
          description: Zusätzlicher Fehlerkontext
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  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.