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
}Confiança e Testemunha
Obter Consenso de Testemunhas
Recupere o resultado de consenso para uma solicitação de verificação de testemunha
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
}Retorna o estado de consenso atual para uma solicitação de testemunha, incluindo contagens de votos e determinação final. Use este endpoint para pesquisar a conclusão do consenso ou para recuperar o resultado final após as testemunhas terem atestado.
O consenso é calculado automaticamente quando o número de atestações atinge o limite
required_witnesses. Uma maioria simples de veredictos confirm ou deny determina o resultado. Os votos abstain contam para o quórum, mas não influenciam o cálculo da maioria.
Autenticação
Requer cabeçalhoX-API-Key ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie X-Tenant-ID.
Resposta
Status atual da solicitação de testemunha. Um de: -
pending — ainda aguardando
atestações - confirmed — consenso alcançado, reivindicação confirmada - denied
— consenso alcançado, reivindicação negada - expired — TTL decorrido sem
atingindo o quórumCarimbo de data/hora ISO 8601 de quando o consenso foi alcançado.
null se ainda pendente ou
expirou sem consenso.Lógica de Consenso
| Cenário | Resultado |
|---|---|
Quórum atingido, maioria confirm | confirmed |
Quórum atingido, maioria deny | denied |
Quórum atingido, confirm/deny iguais | Ponderado por pontuações de confiança; a maior confiança agregada vence |
| TTL expira antes do quórum | expired |

