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))
}Vérifier l'attestation
Vérifiez le statut de l’enregistrement, les métadonnées de l’émetteur et les preuves disponibles. Fournissez la charge utile_b64url originale exacte pour vérifier la signature cryptographique. Une recherche par ID uniquement ou par empreinte de fichier uniquement renvoie INCOMPLET avec signature_verified false si aucune défaillance plus grave ne s’applique. VALIDE signifie que la charge utile fournie a passé les vérifications de signature ; cela ne prouve pas la véracité des affirmations ni ne garantit que les vérifications facultatives de politique et de transparence sont terminées. Inspectez les raisons et log.proof_checked. Les requêtes publiques n’ont pas besoin de clé API ; les requêtes authentifiées sont limitées et mesurées par rapport à l’espace de travail de l’appelant.
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))
}payload_b64url. Un ID d’enregistrement ou une empreinte de fichier seul ne peut pas fournir ces octets.
Choisissez la vérification dont vous avez besoin
| Entrée | Ce qu’il vérifie |
|---|---|
attestation_id | Trouve un enregistrement accessible et vérifie son statut actuel, les métadonnées de l’émetteur et les preuves de journal disponibles. |
ID plus payload_b64url | Vérifie également le condensé de la charge utile et la signature par rapport à la clé publique enregistrée. Encodez les octets d’origine ; le reformatage de JSON peut modifier ces octets. |
ID plus document_hash_hex | Compare une empreinte SHA-256 fournie avec l’empreinte du document enregistrée. Cela ne remplace pas la vérification de la charge utile signée. |
INCOMPLETE et signature_verified: false à moins qu’un résultat plus fort tel que REVOKED, EXPIRED ou ALTERED ne s’applique. Fournissez la charge utile originale pour une vérification complète de la signature.
Un attestation en ligne doit identifier un enregistrement enregistré avec attestation_id. L’état en ligne et l’identité de la clé sont chargés à partir de cet enregistrement ; les champs fournis par l’appelant ne peuvent pas remplacer son émetteur ou sa révocation. Utilisez un vérificateur hors ligne compatible pour les vérifications de signature autonomes.
Interpréter la réponse
| Verdict | Signification |
|---|---|
VALID | La charge utile fournie a passé sa vérification de signature et aucune erreur bloquante n’a été renvoyée. Inspectez les raisons et les vérifications individuelles. |
INCOMPLETE | Le contenu original requis n’a pas été fourni ; la signature n’a pas été vérifiée. |
ALTERED | Une charge utile, une signature ou une empreinte de document fournie n’a pas réussi un contrôle d’intégrité. |
REVOKED | L’enregistrement a été révoqué. |
SUPERSEDED | Un enregistrement plus récent remplace celui-ci. Demandez à l’émetteur son enregistrement actuel. |
EXPIRED | L’enregistrement ou la clé de signature a expiré. |
INVALID | Une entrée requise ou une vérification a échoué. |
NOT_FOUND | Aucun enregistrement accessible ne correspondait à la requête et à son environnement. |
UNKNOWN_ISSUER | La clé de signature de l’émetteur n’a pas pu être acceptée. |
signature_verified signale spécifiquement la vérification de la signature. log.proof_checked signale la vérification réussie de l’inclusion de la transparence. Une preuve manquante produit une raison et un index de feuille nul ; zéro est une première feuille légitime. Une valeur expires_at_unix absente ne signifie pas qu’une nouvelle expiration doit être inventée pour un enregistrement historique.
reasons, la gouvernance actuelle de l’émetteur et les preuves disponibles avant de vous fier à un enregistrement. Les vérifications facultatives de politique ou de journal peuvent être indisponibles même si la signature de la charge utile est valide.Authentification et limites
La vérification publique ne nécessite pas de clé API. Les appels authentifiés utilisent l’espace de travail et l’environnement de l’appelant et peuvent être soumis à son allocation de vérification. Les limites de débit du service s’appliquent toujours aux requêtes publiques. Un enregistrement privé ou de bac à sable peut ne pas être disponible via une recherche de production anonyme. Partagez un enregistrement accessible en utilisanthttps://verify.truthlocks.com/proof/{attestation_id}. Une URL partagée n’accorde pas l’accès aux charges utiles privées.Corps
Réponse
Résultat de la vérification
Preuve de vérification publique. Inspectez les raisons et les vérifications individuelles ; une vérification par ID seul ne vérifie pas le contenu original fourni par l'appelant.
Examinez les raisons, les entrées de vérification fournies et log.proof_checked en parallèle de ce verdict. VALID seul n'établit pas la propriété ni ne prouve chaque affirmation dans l'enregistrement.
VALID, INCOMPLETE, INVALID, REVOKED, ALTERED, SUPERSEDED, EXPIRED, UNKNOWN_ISSUER, NOT_FOUND 
