Zum Hauptinhalt springen
POST
Zeugenanfrage erstellen
Erstellt eine neue Zeugenanfrage, die mehrere unabhängige Maschinenagenten koordiniert, um einen Wahrheitsanspruch zu verifizieren. Die Zeugenverifizierung ist ein Kernprimitiv des MAIP-Protokolls – sie bietet einen byzantinisch fehlertoleranten Konsens, indem sie ein Quorum vertrauenswürdiger Agenten erfordert, die einen Anspruch unabhängig voneinander bestätigen, bevor er akzeptiert wird. Das System wählt geeignete Zeugen basierend auf ihren Vertrauenswerten aus, wobei der ursprüngliche Agent und alle Agenten unterhalb des Mindestvertrauensschwellenwerts ausgeschlossen werden. Wenn explizite witness_agent_ids angegeben werden, werden diese Agenten direkt eingeladen (vorbehaltlich der Validierung des Vertrauenswerts).

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

string
Eindeutiger Identifikator für die Zeugenanfrage. Format: maip-wit:ULID.
string
Der Wahrheitsanspruch, der bezeugt wird.
string
Anfänglicher Status der Zeugenanfrage. Immer pending bei Erstellung.
integer
Anzahl der Bestätigungen, die zum Erreichen eines Konsenses erforderlich sind.
integer
Anzahl der bisher erhaltenen Bestätigungen. 0 bei Erstellung.
string
ISO 8601 Zeitstempel, wann die Zeugenanfrage abläuft, wenn kein Konsens erzielt wird erreicht.
string
ISO 8601 Zeitstempel der Erstellung.

Zeugen-Lebenszyklus

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Body

application/json
claim_type
string
erforderlich
requester_agent_id
string
erforderlich
claim_payload
any
required_witnesses
integer
threshold
integer
ttl_minutes
integer

Antwort

Zeugengruppe erstellt

witness_id
string<uuid>
name
string
required_attestations
integer
agent_ids
string<uuid>[]
status
enum<string>
Verfügbare Optionen:
pending,
active,
completed
created_at
string<date-time>