Saltar al contenido principal
POST
Crear solicitud de testigo
Crea una nueva solicitud de testigo que coordina múltiples agentes de máquina independientes para verificar una declaración de verdad. La verificación de testigos es una primitiva central del protocolo MAIP: proporciona consenso tolerante a fallas bizantinas al requerir que un quórum de agentes confiables atestigüe independientemente una declaración antes de que sea aceptada. El sistema selecciona testigos elegibles en función de sus puntuaciones de confianza, excluyendo al agente de origen y a cualquier agente por debajo del umbral de confianza mínimo. Si se proporcionan witness_agent_ids explícitos, esos agentes son invitados directamente (sujeto a la validación de la puntuación de confianza).

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

string
Identificador único para la solicitud de testigo. Formato: maip-wit:ULID.
string
La reclamación de verdad que se está atestiguando.
string
Estado inicial de la solicitud de testigo. Siempre pending al crear.
integer
Número de atestaciones necesarias para alcanzar el consenso.
integer
Número de atestaciones recibidas hasta ahora. 0 en la creación.
string
Marca de tiempo ISO 8601 cuando la solicitud de testigo expirará si no hay consenso alcanzado.
string
Marca de tiempo de creación ISO 8601.

Ciclo de vida del testigo

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

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

Respuesta

Grupo de testigos creado

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