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

# Zeugen-Konsens abrufen

> Rufen Sie das Konsensergebnis für eine Zeugenverifizierungsanfrage ab

Gibt den aktuellen Konsensstatus für eine Zeugenanfrage zurück, einschließlich Stimmenauszählungen und endgültiger Entscheidung. Verwenden Sie diesen Endpunkt, um das Ende des Konsenses abzufragen oder das Endergebnis abzurufen, nachdem Zeugen bestätigt haben.

Der Konsens wird automatisch berechnet, wenn die Anzahl der Bestätigungen den Schwellenwert `required_witnesses` erreicht. Eine einfache Mehrheit von `confirm` oder `deny` Urteilen bestimmt das Ergebnis. `abstain` Stimmen zählen zum Quorum, beeinflussen aber nicht die Mehrheitsberechnung.

### Authentifizierung

Erfordert `X-API-Key` Header oder Bearer JWT Token. Der Arbeitsbereich wird aus den authentifizierten Anmeldeinformationen abgeleitet; senden Sie `X-Tenant-ID` nicht.

### Antwort

**id** `string`

Der Bezeichner der Zeugenanfrage.

**claim\_id** `string`

Der Wahrheitsanspruch, der bezeugt wurde.

**status** `string`

Aktueller Status der Zeugenanfrage. Einer von: - `pending` -- wartet noch
Bestätigungen – `confirmed` – Konsens erreicht, Anspruch bestätigt – `denied`
\-- Konsens erreicht, Anspruch wird abgelehnt - `expired` -- TTL abgelaufen ohne
Erreichen des Quorums

**required\_witnesses** `integer`

Anzahl der für den Konsens erforderlichen Bestätigungen.

**confirmations** `integer`

Anzahl der erhaltenen `confirm` Urteile.

**denials** `integer`

Anzahl der erhaltenen `deny` Urteile.

**abstentions** `integer`

Anzahl der erhaltenen `abstain` Urteile.

**consensus\_reached** `boolean`

Ob das erforderliche Quorum erreicht und eine Entscheidung getroffen wurde.

**consensus\_at** `string`

ISO 8601 Zeitstempel, wann Konsens erreicht wurde. `null`, wenn noch ausstehend oder
abgelaufen ohne Konsens.

**expires\_at** `string`

ISO 8601 Zeitstempel, wann die Zeugenanfrage abläuft (oder abgelaufen ist).

### Konsenslogik

| Szenario | Ergebnis |
| :- | :- |
| Quorum erreicht, Mehrheit `confirm` | `confirmed` |
| Quorum erreicht, Mehrheit `deny` | `denied` |
| Quorum erreicht, gleich `confirm`/`deny` | Gewichtet nach Konfidenz-Scores; höchste aggregierte Konfidenz gewinnt |
| TTL läuft vor Quorum ab | `expired` |


## OpenAPI

````yaml de/mint-openapi.yaml GET /v1/witness/{witnessRequestID}/consensus
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/witness/{witnessRequestID}/consensus:
    get:
      tags:
        - Machine Identity
      summary: Konsens prüfen
      description: >-
        Prüft, ob die Zeugengruppe den erforderlichen Attestierungsschwellenwert
        erreicht hat. Gibt die aktuelle Attestierungsanzahl und die gesammelten
        Signaturen zurück.
      operationId: maip.witness.consensus
      parameters:
        - name: witnessRequestID
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Zeugengruppen-Identifikator
      responses:
        '200':
          description: Konsensstatus
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaipConsensus'
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Zeugengruppe nicht gefunden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Ratenlimit überschritten
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    MaipConsensus:
      type: object
      properties:
        reached:
          type: boolean
        attestation_count:
          type: integer
        required:
          type: integer
        signatures:
          type: array
          items:
            type: string
    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.