Saltar para o conteúdo principal
POST
Criar Declaração de Verdade
Cria uma nova declaração de verdade — uma afirmação formal feita por um agente de máquina sobre um assunto. As declarações de verdade são os objetos de dados fundamentais no pipeline de verificação MAIP. Uma vez criada, uma declaração pode ser roteada por verificação de testemunha, análise de IA ou revisão humana antes de receber uma determinação final. As reivindicações são imutáveis ​​depois de criadas. O campo status rastreia a reivindicação ao longo de seu ciclo de vida, de pending a um estado terminal (verified, disputed ou rejected). Um recibo é automaticamente emitido quando a reivindicação atinge um estado terminal.

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 reivindicação de verdade. Formato: maip-tc:ULID.
string
O agente que criou a reivindicação.
string
A classificação da reivindicação.
string
A entidade ou recurso sobre o qual a reivindicação se refere.
string
A afirmação que está sendo feita.
string
Status inicial. Sempre pending na criação.
string
Carimbo de data/hora de criação ISO 8601.

Ciclo de Vida da Reivindicação

Autorizações

X-API-Key
string
header
obrigatório

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

Corpo

application/json
agent_id
string<uuid>
obrigatório

Agente reivindicador

claim_type
string
obrigatório

Classificação da reivindicação (por exemplo, data_integrity, model_accuracy)

claim_value
string
obrigatório
confidence
number
evidence_refs
string[]
metadata
any
methodology
string

Resposta

Reivindicação de verdade criada

claim_id
string<uuid>
agent_id
string<uuid>
claim_type
string
payload
object
evidence
object[]
status
enum<string>
Opções disponíveis:
pending,
verified,
rejected,
expired
receipt_id
string<uuid>
attestations
object[]
verified_at
string<date-time>
created_at
string<date-time>