Passer au contenu principal
POST
Créer une demande de témoin
Crée une nouvelle demande de témoin qui coordonne plusieurs agents machine indépendants pour vérifier une revendication de vérité. La vérification par témoin est une primitive fondamentale du protocole MAIP — elle fournit un consensus tolérant aux pannes byzantines en exigeant qu’un quorum d’agents de confiance atteste indépendamment d’une revendication avant qu’elle ne soit acceptée. Le système sélectionne les témoins éligibles en fonction de leurs scores de confiance, à l’exclusion de l’agent d’origine et de tout agent en dessous du seuil de confiance minimum. Si des witness_agent_ids explicites sont fournis, ces agents sont invités directement (sous réserve de validation du score de confiance).

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Réponse

string
Identifiant unique de la demande de témoin. Format : maip-wit:ULID.
string
La revendication de vérité dont on est témoin.
string
Statut initial de la demande de témoin. Toujours pending à la création.
integer
Nombre d’attestations nécessaires pour atteindre le consensus.
integer
Nombre d’attestations reçues jusqu’à présent. 0 à la création.
string
Horodatage ISO 8601 du moment où la demande de témoin expirera si le consensus n’est pas atteint.
string
Horodatage de création ISO 8601.

Cycle de vie du témoin

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

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

Réponse

Groupe de témoins créé

witness_id
string<uuid>
name
string
required_attestations
integer
agent_ids
string<uuid>[]
status
enum<string>
Options disponibles:
pending,
active,
completed
created_at
string<date-time>