Passer au contenu principal
POST
Créer une revendication de vérité
Crée une nouvelle revendication de vérité — une assertion formelle faite par un agent machine à propos d’un sujet. Les revendications de vérité sont les objets de données fondamentaux dans le pipeline de vérification MAIP. Une fois créée, une revendication peut être acheminée via la vérification par témoin, l’analyse IA ou l’examen humain avant de recevoir une détermination finale. Les réclamations sont immuables une fois créées. Le champ status suit la réclamation tout au long de son cycle de vie, de pending à un état terminal (verified, disputed, ou rejected). Un reçu est automatiquement émis lorsque la réclamation atteint un état terminal.

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 déclaration de vérité. Format : maip-tc:ULID.
string
L’agent qui a créé la réclamation.
string
La classification de la réclamation.
string
L’entité ou la ressource à laquelle la revendication se rapporte.
string
L’affirmation faite.
string
Statut initial. Toujours pending à la création.
string
Horodatage de création ISO 8601.

Cycle de vie des réclamations

Autorisations

X-API-Key
string
header
requis

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

Corps

application/json
agent_id
string<uuid>
requis

Agent de réclamation

claim_type
string
requis

Classification de la réclamation (par exemple, data_integrity, model_accuracy)

claim_value
string
requis
confidence
number
evidence_refs
string[]
metadata
any
methodology
string

Réponse

Revendication de vérité créée

claim_id
string<uuid>
agent_id
string<uuid>
claim_type
string
payload
object
evidence
object[]
status
enum<string>
Options disponibles:
pending,
verified,
rejected,
expired
receipt_id
string<uuid>
attestations
object[]
verified_at
string<date-time>
created_at
string<date-time>