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

# Vertrauens-Score berechnen

> Berechnet den Vertrauenswürdigkeitswert für einen Maschinenagenten basierend auf aktuellen Verhaltenssignalen neu

Löst eine bedarfsgesteuerte Neuberechnung des Vertrauens-Scores für einen bestimmten Agenten aus. Der Score wird aus mehreren gewichteten Faktoren abgeleitet, darunter Anomalierate, Verfügbarkeitsverlauf, Delegationstiefe und Belegvolumen. Verwenden Sie diesen Endpunkt nach einem signifikanten Ereignis (Schlüsselrotation, Richtlinienverletzung, Bestätigungs-Burst), um sicherzustellen, dass der Score die aktuelle Haltung des Agenten widerspiegelt.

Vertrauens-Scores reichen von `0.0` (kein Vertrauen) bis `1.0` (volles Vertrauen) und werden von Richtlinien-Engines, Zeugenauswahl und Delegations-Gates auf der gesamten Plattform verwendet.

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

**agent\_id** `string`

Der Agentenbezeichner, der bewertet wurde.

**score** `number`

Der berechnete Vertrauens-Score als Gleitkommazahl zwischen `0.0` und `1.0`.

**factors** `object`

Aufschlüsselung der einzelnen Faktoren, die zur Bewertung beigetragen haben.

**Factor fields**

**factors.anomaly\_rate** `number`

Verhältnis von anomalen Ereignissen zu Gesamtereignissen im Bewertungsfenster. Niedriger ist besser.

**factors.uptime** `number`

Verfügbarkeitsrate des Agenten in den letzten 30 Tagen. `1.0` bedeutet 100 % Verfügbarkeit.

**factors.delegation\_depth** `integer`

Aktuelle Tiefe der Delegationskette des Agenten. Tiefe Ketten reduzieren das Vertrauen.

**factors.receipt\_count** `integer`

Gesamtzahl der gültigen Belege, die der Agent gesammelt hat.

**computed\_at** `string`

ISO 8601 Zeitstempel, wann die Berechnung abgeschlossen wurde.

### Gewichtung der Score-Faktoren

| Faktor | Gewicht | Beschreibung |
| :- | :- | :- |
| `anomaly_rate` | 30% | Bestraft Agenten mit hohen Anomaliequoten |
| `uptime` | 25% | Belohnt konsistente Verfügbarkeit |
| `delegation_depth` | 20% | Tiefere Ketten reduzieren das Vertrauen proportional |
| `receipt_count` | 25% | Mehr Belege deuten auf eine etablierte Historie hin |


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/trust/compute
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/trust/compute:
    post:
      tags:
        - Machine Identity
      summary: Vertrauenswürdigkeitswert neu berechnen
      description: >-
        Erzwingt eine sofortige Neuberechnung des Agenten-Vertrauens-Scores
        unter Verwendung der neuesten Signale. Gibt die einzelnen beitragenden
        Faktoren zurück.
      operationId: maip.agents.trust.compute
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                agent_id:
                  type: string
                  description: MAIP-Agenten-Identifikator (z.B. maip:a0000000:01abc...)
              type: object
              required:
                - agent_id
      responses:
        '200':
          description: Neuberechneter Vertrauenswürdigkeitswert
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaipTrustScore'
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Agent 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:
    MaipTrustScore:
      type: object
      properties:
        score:
          type: number
          format: float
          minimum: 0
          maximum: 1
        factors:
          type: object
          additionalProperties: true
        deltas:
          type: object
          additionalProperties: true
        computed_at:
          type: string
          format: date-time
    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.