Créer une demande de témoin
curl --request POST \
--url https://api.truthlocks.com/v1/witness/request \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({claim_type: '<string>', requester_agent_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/witness/request', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/witness/request"
payload = {
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/witness/request"
payload := strings.NewReader("{\n \"claim_type\": \"<string>\",\n \"requester_agent_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"witness_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"required_attestations": 123,
"agent_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"status": "pending",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Confiance et Témoin
Créer une demande de témoin
Lancer une vérification de témoin multi-agents pour une affirmation de vérité
POST
/
v1
/
witness
/
request
Créer une demande de témoin
curl --request POST \
--url https://api.truthlocks.com/v1/witness/request \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({claim_type: '<string>', requester_agent_id: '<string>'})
};
fetch('https://api.truthlocks.com/v1/witness/request', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/witness/request"
payload = {
"claim_type": "<string>",
"requester_agent_id": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/witness/request"
payload := strings.NewReader("{\n \"claim_type\": \"<string>\",\n \"requester_agent_id\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"witness_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"required_attestations": 123,
"agent_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"status": "pending",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}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êteX-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
Horodatage ISO 8601 du moment où la demande de témoin expirera si le consensus n’est pas
atteint.
Cycle de vie du témoin
| Statut | Description |
|---|---|
pending | Créé, en attente d’attestations de témoins |
confirmed | Quorum atteint avec une majorité de verdicts confirm |
denied | Quorum atteint avec une majorité de verdicts deny |
expired | TTL écoulé sans atteindre le consensus |
Corps
application/json

