curl --request POST \
--url https://api.truthlocks.com/v1/verify \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
attestation: {
attestation_id: '<string>',
document_hash: '<string>',
expires_at_unix: 123,
issued_at_unix: 123,
issuer_id: '<string>',
log: {
log_id: '<string>',
leaf_index: 123,
leaf_hash: '<string>',
proof_url: '<string>'
},
payload_hash: '<string>',
signature: {alg: '<string>', kid: '<string>', value: '<string>'},
status: '<string>',
tenant_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
version: '<string>'
},
attestation_id: '<string>',
document_hash_hex: '<string>',
payload_b64url: '<string>'
})
};
fetch('https://api.truthlocks.com/v1/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/verify"
payload = {
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<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/verify"
payload := strings.NewReader("{\n \"attestation\": {\n \"attestation_id\": \"<string>\",\n \"document_hash\": \"<string>\",\n \"expires_at_unix\": 123,\n \"issued_at_unix\": 123,\n \"issuer_id\": \"<string>\",\n \"log\": {\n \"log_id\": \"<string>\",\n \"leaf_index\": 123,\n \"leaf_hash\": \"<string>\",\n \"proof_url\": \"<string>\"\n },\n \"payload_hash\": \"<string>\",\n \"signature\": {\n \"alg\": \"<string>\",\n \"kid\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"tenant_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"version\": \"<string>\"\n },\n \"attestation_id\": \"<string>\",\n \"document_hash_hex\": \"<string>\",\n \"payload_b64url\": \"<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))
}{
"verdict": "VALID",
"valid": true,
"details": {
"issuer_id": "550e8400-e29b-41d4-a716-446655440000",
"issuer_name": "Acme University",
"log_index": 42
}
}Verificar Atestado
Verifique o status do registro, metadados do emissor e evidências disponíveis. Forneça o payload_b64url original exato para verificar a assinatura criptográfica. Uma pesquisa apenas por ID ou apenas por impressão digital de arquivo retorna INCOMPLETO com signature_verified false se nenhuma falha mais forte se aplicar. VÁLIDO significa que o payload fornecido passou nas verificações de assinatura; isso não prova a veracidade das reivindicações nem garante que as verificações opcionais de política e transparência foram concluídas. Inspecione os motivos e log.proof_checked. Solicitações públicas não precisam de chave de API; solicitações autenticadas são escopadas e medidas em relação ao espaço de trabalho do chamador.
curl --request POST \
--url https://api.truthlocks.com/v1/verify \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
attestation: {
attestation_id: '<string>',
document_hash: '<string>',
expires_at_unix: 123,
issued_at_unix: 123,
issuer_id: '<string>',
log: {
log_id: '<string>',
leaf_index: 123,
leaf_hash: '<string>',
proof_url: '<string>'
},
payload_hash: '<string>',
signature: {alg: '<string>', kid: '<string>', value: '<string>'},
status: '<string>',
tenant_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
version: '<string>'
},
attestation_id: '<string>',
document_hash_hex: '<string>',
payload_b64url: '<string>'
})
};
fetch('https://api.truthlocks.com/v1/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/verify"
payload = {
"attestation": {
"attestation_id": "<string>",
"document_hash": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"issuer_id": "<string>",
"log": {
"log_id": "<string>",
"leaf_index": 123,
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"status": "<string>",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>"
},
"attestation_id": "<string>",
"document_hash_hex": "<string>",
"payload_b64url": "<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/verify"
payload := strings.NewReader("{\n \"attestation\": {\n \"attestation_id\": \"<string>\",\n \"document_hash\": \"<string>\",\n \"expires_at_unix\": 123,\n \"issued_at_unix\": 123,\n \"issuer_id\": \"<string>\",\n \"log\": {\n \"log_id\": \"<string>\",\n \"leaf_index\": 123,\n \"leaf_hash\": \"<string>\",\n \"proof_url\": \"<string>\"\n },\n \"payload_hash\": \"<string>\",\n \"signature\": {\n \"alg\": \"<string>\",\n \"kid\": \"<string>\",\n \"value\": \"<string>\"\n },\n \"status\": \"<string>\",\n \"tenant_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"version\": \"<string>\"\n },\n \"attestation_id\": \"<string>\",\n \"document_hash_hex\": \"<string>\",\n \"payload_b64url\": \"<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))
}{
"verdict": "VALID",
"valid": true,
"details": {
"issuer_id": "550e8400-e29b-41d4-a716-446655440000",
"issuer_name": "Acme University",
"log_index": 42
}
}payload_b64url. Um ID de registro ou impressão digital de arquivo sozinho não pode fornecer esses bytes.
Escolha a verificação que você precisa
| Entrada | O que verifica |
|---|---|
attestation_id | Encontra um registo acessível e verifica o seu estado atual, metadados do emissor e evidências de registo disponíveis. |
ID mais payload_b64url | Também verifica o resumo da carga útil e a assinatura em relação à chave pública registrada. Codifique os bytes originais; a reformatação de JSON pode alterar esses bytes. |
ID mais document_hash_hex | Compara uma impressão digital SHA-256 fornecida com a impressão digital do documento registrada. Isso não substitui a verificação da carga útil assinada. |
INCOMPLETE e signature_verified: false, a menos que um resultado mais forte, como REVOKED, EXPIRED ou ALTERED, se aplique. Forneça o payload original para uma verificação de assinatura completa.
Um attestation inline deve identificar um registo registado com attestation_id. O status online e a identidade da chave são carregados desse registo; os campos fornecidos pelo chamador não podem substituir o seu emissor ou revogação. Use um verificador offline compatível para verificações de assinatura autónomas.
Interpretar a resposta
| Veredito | Significado |
|---|---|
VALID | O payload fornecido passou na verificação de assinatura e nenhuma falha de bloqueio foi retornada. Inspecione os motivos e as verificações individuais. |
INCOMPLETE | O conteúdo original necessário não foi fornecido; a assinatura não foi verificada. |
ALTERED | Uma carga útil, assinatura ou impressão digital de documento fornecida falhou em uma verificação de integridade. |
REVOKED | O registro foi revogado. |
SUPERSEDED | Um registro mais recente substitui este. Peça ao emissor seu registro atual. |
EXPIRED | O registro ou a chave de assinatura expirou. |
INVALID | Uma entrada ou verificação obrigatória falhou. |
NOT_FOUND | Nenhum registro acessível correspondeu à solicitação e ao seu ambiente. |
UNKNOWN_ISSUER | A chave de assinatura do emissor não pôde ser aceita. |
signature_verified relata especificamente a verificação da assinatura. log.proof_checked relata a verificação bem-sucedida da inclusão de transparência. Uma prova ausente produz uma razão e um índice de folha nulo; zero é uma primeira folha legítima. Um valor expires_at_unix ausente não significa que uma nova expiração deva ser inventada para um registro histórico.
reasons, a governança atual do emissor e as evidências disponíveis antes de confiar em um registro. As verificações opcionais de política ou log podem não estar disponíveis mesmo quando a assinatura da carga útil é aprovada.Autenticação e limites
A verificação pública não requer uma chave de API. Chamadas autenticadas usam o espaço de trabalho e o ambiente do chamador e podem estar sujeitas à sua permissão de verificação. Os limites de taxa de serviço ainda se aplicam a solicitações públicas. Um registro privado ou de sandbox pode não estar disponível por meio de uma pesquisa de produção anônima. Compartilhe um registro acessível usandohttps://verify.truthlocks.com/proof/{attestation_id}. Uma URL compartilhada não concede acesso a cargas úteis privadas.Corpo
Resposta
Resultado da verificação
Evidência de verificação pública. Inspecione os motivos e as verificações individuais; uma verificação apenas de ID não verifica o conteúdo original fornecido pelo chamador.
Inspecione as razões, as entradas de verificação fornecidas e log.proof_checked junto com este veredito. VALID por si só não estabelece propriedade nem prova todas as alegações no registro.
VALID, INCOMPLETE, INVALID, REVOKED, ALTERED, SUPERSEDED, EXPIRED, UNKNOWN_ISSUER, NOT_FOUND 
