sproof Validate: Signaturen prüfen (API)

Hallo Entwicker:in,

Dieser Guide erklärt, wie Sie die Gültigkeit von digitalen Signaturen in einem Dokument mithilfe der sproof API überprüfen können. Dieser Prozess ist ideal für automatisierte Workflows, bei denen der Validierungsstatus eines Dokuments programmatisch ermittelt werden muss.

Die Prüfung basiert auf den ETSI-Standards, die international anerkannte Normen für elektronische Signaturen darstellen.

Die Prüfung erfolgt über den POST Endpunkt documents/verify. Dieser Endpunkt akzeptiert ein Dokument und gibt den Validierungsstatus aller darin enthaltenen Signaturen zurück.

API-Call: POST https://sign.sproof.com/api/v1/documents/verify

Dokumentation: Signaturen prüfen

Body-Struktur (JSON):

{
  "token": "{{token}}"
  "document": "{{pdf_im_base64_format}}"
}

{{pdf_im_base64_format}} sollte das Base64-kodierte PDF-Dokument enthalten dessen Signaturen Sie prüfen möchten.
Ersetzen Sie {{token}} durch Ihren API-Token.

Die API gibt im Erfolgsfall ein JSON-Objekt zurück, das den Validierungsstatus der Signaturen enthält.

Beispiel für eine erfolgreiche Antwort:

{
    "totalSignaturesCount": 1,
    "validSignaturesCount": 1,
    "signatureVerificationInfos": [
        {
            "id": "S-430E6C02C35FA4A4D03743BF92F7D5E3332E1F2672E43B4ADD25911B163D15CA",
            "qualification": "urn:cef:dss:signatureQualification:AdESealQC",
            "format": "PKCS7-B",
            "indication": "urn:etsi:019102:mainindication:total-passed",
            "subIndication": null,
            "certificateChain": [
                "sproof GmbH",
                "D-TRUST CA 5-22-2 2022",
                "D-TRUST Root CA 5 2022"
            ],
            "signatureTime": "Thu Aug 21 15:00:08 UTC 2025",
            "bestSignatureTime": "Thu Aug 21 15:11:14 UTC 2025",
            "byteRange": "The document ByteRange : [0, 46428, 106430, 140889]",
            "name": "Max Mustermann [max.mustermann@sproof.com]",
            "signatureTimestampVerificationInfo": null
        }
    ]
}

Wir hoffen, dieses Beispiel hilft Ihnen beim Start Ihrer Integration!

Bei Fragen stehen wir Ihnen gerne zur Verfügung.