Signaturketten

Rufen Sie die vollständige Signaturkette eines Dokuments ab, die die Signaturhistorie vom Original bis zur neuesten Version zeigt.

Signaturkette abrufen

Endpunkt: GET /api/sdk/v1/documents/:id/signature-chain

Parameter	Typ	Erforderlich	Beschreibung
documentId	string	Ja	Die Dokumentkennung

Antwort (SignatureChain)

Feld	Typ	Beschreibung
originalDocumentId	string	ID des Originaldokuments (erstes Dokument)
chainLength	number	Gesamtanzahl der Dokumente in der Kette
documents	SignatureChainDocument[]	Geordnetes Array der Kettendokumente

Kettendokument-Felder (SignatureChainDocument)

Feld	Typ	Beschreibung
id	string	Dokument-ID
name	string	Dokumentname
isSigned	boolean	Ob diese Version signiert ist
signatureType	SignatureType?	Art der angewendeten Signatur ('SIMPLE', 'ADVANCE', 'AES')
signature	object?	Signaturdetails (signedAt, certificateId, isPadesCompliant)
signatureChainOrder	number	Position in der Kette (0-basiert)
isLatestVersion	boolean	Ob dies die neueste Version ist
parentDocumentId	string | null	ID des übergeordneten Dokuments in der Kette
originalDocumentId	string | null	ID des Originaldokuments
createdAt	string	ISO 8601 Erstellungszeitstempel

Signaturtypen

Typ	Beschreibung
'SIMPLE'	Einfache elektronische Signatur
'ADVANCE'	Fortgeschrittene elektronische Signatur
'AES'	Qualifizierte elektronische Signatur (Advanced Electronic Signature)

Beispiel

const chain = await sdk.documents.getSignatureChain('doc_abc123');

console.log(`Kette hat ${chain.chainLength} Versionen`);
console.log(`Originaldokument: ${chain.originalDocumentId}`);

for (const doc of chain.documents) {
  const status = doc.isSigned ? `Signiert (${doc.signatureType})` : 'Unsigniert';
  const latest = doc.isLatestVersion ? ' [NEUESTE]' : '';
  console.log(`  #${doc.signatureChainOrder}: ${doc.name} — ${status}${latest}`);
}