Crear solicitud de testigo
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
}Confianza y Testigo
Crear solicitud de testigo
Iniciar una verificación de testigo multiagente para una afirmación de verdad
POST
/
v1
/
witness
/
request
Crear solicitud de testigo
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
}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 encabezadoX-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.
Respuesta
Marca de tiempo ISO 8601 cuando la solicitud de testigo expirará si no hay consenso
alcanzado.
Ciclo de vida del testigo
| Estado | Descripción |
|---|---|
pending | Creado, pendiente de atestaciones de testigos |
confirmed | Quórum alcanzado con veredictos de mayoría confirm |
denied | Quórum alcanzado con veredictos de mayoría deny |
expired | TTL transcurrido sin alcanzar el consenso |
Cuerpo
application/json

