Saltar para o conteúdo principal
POST
Criar Solicitação de Testemunha
Cria uma nova solicitação de testemunha que coordena múltiplos agentes de máquina independentes para verificar uma declaração de verdade. A verificação de testemunha é uma primitiva central do protocolo MAIP — ela fornece consenso tolerante a falhas bizantinas, exigindo que um quorum de agentes confiáveis ateste independentemente uma declaração antes que ela seja aceita. O sistema seleciona testemunhas elegíveis com base em suas pontuações de confiança, excluindo o agente de origem e quaisquer agentes abaixo do limite mínimo de confiança. Se witness_agent_ids explícitos forem fornecidos, esses agentes são convidados diretamente (sujeito à validação da pontuação de confiança).

Autenticação

Requer cabeçalho X-API-Key ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie X-Tenant-ID.

Resposta

string
Identificador único para a solicitação de testemunha. Formato: maip-wit:ULID.
string
A reivindicação de verdade sendo testemunhada.
string
Status inicial da solicitação de testemunha. Sempre pending na criação.
integer
Número de atestados necessários para alcançar o consenso.
integer
Número de atestados recebidos até agora. 0 na criação.
string
Carimbo de data/hora ISO 8601 quando a solicitação de testemunha expirará se o consenso não for atingido.
string
Carimbo de data/hora de criação ISO 8601.

Ciclo de Vida da Testemunha

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
claim_type
string
obrigatório
requester_agent_id
string
obrigatório
claim_payload
any
required_witnesses
integer
threshold
integer
ttl_minutes
integer

Resposta

Grupo de testemunhas criado

witness_id
string<uuid>
name
string
required_attestations
integer
agent_ids
string<uuid>[]
status
enum<string>
Opções disponíveis:
pending,
active,
completed
created_at
string<date-time>