Verificar Consenso
curl --request GET \
--url https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"reached": true,
"attestation_count": 123,
"required": 123,
"signatures": [
"<string>"
]
}{
"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
Obtener Consenso de Testigos
Recuperar el resultado de consenso para una solicitud de verificación de testigo
GET
/
v1
/
witness
/
{witnessRequestID}
/
consensus
Verificar Consenso
curl --request GET \
--url https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/witness/{witnessRequestID}/consensus"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"reached": true,
"attestation_count": 123,
"required": 123,
"signatures": [
"<string>"
]
}{
"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
}Devuelve el estado de consenso actual para una solicitud de testigo, incluyendo recuentos de votos y determinación final. Utilice este endpoint para sondear la finalización del consenso o para recuperar el resultado final después de que los testigos hayan atestiguado.
El consenso se calcula automáticamente cuando el número de atestaciones alcanza el umbral
required_witnesses. Una mayoría simple de veredictos confirm o deny determina el resultado. Los votos abstain cuentan para el quórum pero no influyen en el cálculo de la mayoría.
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
Estado actual de la solicitud de testigo. Uno de: -
pending — aún esperando
atestaciones - confirmed — consenso alcanzado, la reclamación está confirmada - denied
— consenso alcanzado, la reclamación es denegada - expired — TTL transcurrido sin
alcanzando el quórumMarca de tiempo ISO 8601 de cuándo se alcanzó el consenso.
null si aún está pendiente o
expiró sin consenso.Lógica de consenso
| Escenario | Resultado |
|---|---|
Quórum alcanzado, mayoría confirm | confirmed |
Quórum alcanzado, mayoría deny | denied |
Quórum alcanzado, igual confirm/deny | Ponderado por puntuaciones de confianza; la mayor confianza agregada gana |
| El TTL expira antes del quórum | expired |

