Zum Hauptinhalt springen
POST
Bestätigung überprüfen
Überprüfen Sie den aktuellen Status eines Datensatzes und die verfügbaren Beweise. Um seine kryptografische Signatur zu überprüfen, senden Sie die exakte original signierte Nutzlast als payload_b64url. Eine Datensatz-ID oder ein Dateifingerabdruck allein kann diese Bytes nicht liefern.

Wählen Sie die benötigte Prüfung

Eine reine ID- oder reine Fingerabdruckprüfung gibt INCOMPLETE und signature_verified: false zurück, es sei denn, ein stärkeres Ergebnis wie REVOKED, EXPIRED oder ALTERED trifft zu. Geben Sie die ursprüngliche Nutzlast für eine vollständige Signaturprüfung an. Ein Inline-attestation muss einen registrierten Datensatz mit attestation_id identifizieren. Der Online-Status und die Schlüsselidentität werden aus diesem Datensatz geladen; vom Aufrufer bereitgestellte Felder können dessen Aussteller oder Widerruf nicht überschreiben. Verwenden Sie einen kompatiblen Offline-Verifizierer für eigenständige Signaturprüfungen.

Die Antwort interpretieren

signature_verified meldet speziell die Signaturprüfung. log.proof_checked meldet die erfolgreiche Überprüfung der Transparenz-Inklusion. Ein fehlender Beweis erzeugt einen Grund und einen Null-Blattindex; Null ist ein legitimes erstes Blatt. Ein fehlender expires_at_unix-Wert bedeutet nicht, dass ein neues Ablaufdatum für einen historischen Datensatz erfunden werden sollte.
Eine gültige Signatur beweist nicht Eigentum, rechtliche Gültigkeit oder die Wahrheit jeder Behauptung. Lesen Sie reasons, die aktuelle Issuer-Governance und die verfügbaren Beweise, bevor Sie sich auf einen Datensatz verlassen. Optionale Richtlinien- oder Protokollprüfungen können auch dann nicht verfügbar sein, wenn die Payload-Signatur erfolgreich ist.

Authentifizierung und Limits

Die öffentliche Verifizierung erfordert keinen API-Schlüssel. Authentifizierte Aufrufe verwenden den Arbeitsbereich und die Umgebung des Anrufers und können dessen Verifizierungsfreigabe unterliegen. Dienst-Ratenbegrenzungen gelten weiterhin für öffentliche Anfragen. Ein privater oder Sandbox-Datensatz ist möglicherweise nicht über eine anonyme Produktionssuche verfügbar. Teilen Sie einen zugänglichen Datensatz mit https://verify.truthlocks.com/proof/{attestation_id}. Eine geteilte URL gewährt keinen Zugriff auf private Nutzdaten.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Body

application/json
attestation
object | null

Online-Nachschlage-Umschlag. Eine registrierte attestation_id ist hier oder auf Anforderungsebene erforderlich. Der gespeicherte Status, Aussteller, Schlüssel und Ausstellungszeitpunkt sind maßgeblich; bereitgestellte Kopien können diese nicht überschreiben.

attestation_id
string
document_hash_hex
string
payload_b64url
string

Antwort

200 - application/json

Verifizierungsergebnis

Öffentliche Verifizierungsnachweise. Überprüfen Sie Gründe und einzelne Prüfungen; eine reine ID-Prüfung verifiziert nicht den vom Anrufer bereitgestellten Originalinhalt.

verdict
enum<string>
erforderlich

Überprüfen Sie die Gründe, die bereitgestellten Verifizierungseingaben und log.proof_checked zusammen mit diesem Urteil. VALID allein begründet weder den Besitz noch beweist es jede Behauptung im Datensatz.

Verfügbare Optionen:
VALID,
INCOMPLETE,
INVALID,
REVOKED,
ALTERED,
SUPERSEDED,
EXPIRED,
UNKNOWN_ISSUER,
NOT_FOUND
signature_verified
boolean

Nur wahr, wenn die bereitgestellte ursprüngliche Nutzlast die kryptografische Signaturprüfung bestanden hat. Nur-ID- und Nur-Fingerabdruck-Prüfungen geben false zurück.

reasons
string[]
attestation_id
string<uuid>
issuer_id
string<uuid>
expires_at_unix
integer<int64> | null

Aufgezeichneter signierter Ablauf in Unix-Sekunden; null bedeutet, dass kein Ablauf aufgezeichnet wird. Älteren Datensätzen wird kein neuer Ablauf zugewiesen.

issued_at_unix
integer<int64>

Ursprüngliche gespeicherte Ausstellungszeit in Unix-Sekunden. Dies ist nicht die Zeit der aktuellen Prüfung oder des Zertifikatsdownloads. Fehlt, wenn nicht verfügbar.

kid
string

Signaturschlüssel-ID.

alg
string

Deklarierter Signaturalgorithmus.

payload_hash
string

Base64url-kodierter SHA-256-Digest der kanonischen Nutzlast.

document_hash
string

Hexadezimaler SHA-256-Fingerabdruck der Originaldatei, wenn gespeichert.

log
object
governance
object