Installation

Das Paket ist verfügbar bei PyPI und kann über pip mit folgendem Befehl installiert werden:

pip install groupdocs-signature-cloud

Anforderungen

• Python 2.7 oder 3.4+
• pip Paketmanager
• GroupDocs Cloud-Anmeldeinformationen — Client ID and Client Secret vom Dashboard

Abhängigkeiten

Das SDK installiert automatisch die folgenden Pakete:

Python Cloud REST API zur elektronischen Dokumentensignierung

GroupDocs.Signature Cloud SDK für Python bietet eine umfassende Lösung zur Integration elektronischer Signaturen in Python-Web-Apps, Skripte und Automatisierungs-Workflows. Es unterstützt eine breite Palette von Signaturtypen — Text, Bild, Barcode, QR-Code, digital und Stempel — in Word-, Excel-, PDF-, Präsentations- und Bildformaten. Entwickler können Erscheinungsbild, Platzierung und Sicherheit von Signaturen anpassen, digitale Zertifikate anwenden, die Authentizität von Signaturen verifizieren und vorhandene Signaturen in Dokumenten suchen. Ob beim Signieren einer einzelnen Seite oder bei der Verwaltung mehrerer Signaturen über eine Dokumentsammlung hinweg – GroupDocs.Signature liefert robuste Werkzeuge für sichere und effiziente cloudbasierte Dokumentensignierung.

Cloud-Funktionen zur Dokumentensignierung

Signaturen auf bestimmte Seiten anwenden - Wenden Sie Signaturen auf gerade, ungerade oder bestimmte Seiten an, für eine präzise Platzierung.
Seitenabstand konfigurieren - Legen Sie den Seitenabstand fest, um Signaturen auf jeder Seite präzise auszurichten.
Erscheinungsbild der Signatur anpassen - Steuern Sie Schriftarten, Farben und Stil von Signaturen.
Hintergrund-Zuschneideeinstellungen anwenden - Verwenden Sie Hintergrund-Zuschneideeinstellungen, um die Sichtbarkeit der Signatur zu verbessern.
Signaturzeichenfolge wiederholen - Wiederholen Sie Signaturzeichenfolgen, um definierte Bereiche zu füllen.
Digitale Signaturen mit CryptoApi & XmlDsig - Unterstützung digitaler Signaturen über CryptoApi und XmlDsig.
Text für Barcode-Signaturen ausrichten - Richten Sie Barcode-Signaturen mit konfigurierbarem Text aus.
Kennwortgeschützte Dokumente signieren - Signieren Sie kennwortgeschützte Dokumente.
Dokumentsignaturen verifizieren - Überprüfen Sie die Authentizität und Gültigkeit von Dokumentsignaturen.
Nach Signaturtypen suchen - Suchen Sie nach bestimmten Signaturtypen in Dokumenten.

Erweiterte Funktionen

Erscheinungsbild der Signatur anpassen - Passen Sie Schriftarten, Farben und Stil der Signatur an.
Mehrere Signaturen verwalten - Verwalten Sie mehrere Signaturen in einem Dokument.
Kennwortschutz für Dokumente - Fügen Sie Kennwortschutz zu signierten Dokumenten hinzu.
Authentizität der Signatur prüfen - Validieren Sie die Authentizität angewendeter Signaturen.
Nach bestimmten Signaturen suchen - Suchen Sie nach Text-, Barcode-, QR-Code- und digitalen Signaturen.
Signaturen aktualisieren und löschen - Ändern oder entfernen Sie vorhandene Signaturen aus Dokumenten.

Barcode- und QR-Code-Signaturen

Unterstützte Formate für Barcode-/QR-Signaturen - Unterstützt DOC, DOCX, XLSX, PDF und Bildformate.
Barcode-/QR-Code-Signaturen anpassen - Passen Sie Erscheinungsbild und Inhalt von Barcode-/QR-Signaturen an.
Barcode-/QR-Code-Verwendungsszenarien - Anwendungsfälle umfassen Dokumentenverfolgung und Identifikation.

Stempelsignaturen

Überblick über Stempelsignaturen - Visuelle und Text-Stempelsignaturen für offizielle Dokumente.
Stempelsignaturen anpassen - Passen Sie Stempelgröße, Text und Erscheinungsbild an.

Unterstützte Signaturtypen

Textsignatur - Fügen Sie anpassbare Textbeschriftungen mit Schriftart, Farbe und Ausrichtung hinzu.
Bildsignatur - Wenden Sie Bildsignaturen mit Deckkraft, Graustufen, Helligkeit und Kontrast an.
Barcode-Signatur - Fügen Sie Barcode-Typen mit flexibler Erscheinungsweise, Ausrichtung und Codierung hinzu.
QR-Code-Signatur - Fügen Sie QR-Code-Signaturen mit anpassbarer Codierung und Erscheinungsbild ein.
Digitale Signatur - Wenden Sie digitale Zertifikate (PFX, CRT) auf Dokumente oder PDF-Seiten an.
Stempelsignatur - Platzieren Sie Stempelbilder auf Seiten mit flexibler Anpassung.

Dateioperationen

Dateien in die Cloud hochladen - Laden Sie Dateien über die API in den Cloud-Speicher hoch.
Dateien aus der Cloud herunterladen - Laden Sie Dateien aus dem Cloud-Speicher auf lokale Systeme herunter.
Dateien kopieren - Kopieren Sie Dateien innerhalb des Cloud-Speichers an andere Speicherorte.
Dateien verschieben - Verschieben Sie Dateien zwischen Ordnern im Cloud-Speicher.
Dateien löschen - Löschen Sie bestimmte Dateien aus dem Cloud-Speicher.

Ordneroperationen

Ordner erstellen - Erstellen Sie neue Ordner im Cloud-Speicher.
Ordner kopieren - Duplizieren Sie Ordner innerhalb des Cloud-Speichers.
Ordner verschieben - Verschieben Sie Ordner zwischen Verzeichnissen im Cloud-Speicher.
Ordner löschen - Entfernen Sie ganze Ordner aus dem Cloud-Speicher.

Lizenzierung und Authentifizierung

Evaluierungsmodus - Testen Sie die API mit einem kostenlosen Testkonto.
Sichere Authentifizierung - Verwenden Sie Client ID und Client Secret für sicheren API-Zugriff.
MIT License - Das Python SDK ist unter der MIT License lizenziert.

Unterstützte Dokumentformate

GroupDocs.Signature Cloud unterstützt Signierung in den folgenden Formatkategorien:

• Textverarbeitung: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, OTT, RTF, TXT
• Tabellenkalkulationen: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Präsentationen: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF: PDF
• Bilder: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF und mehr

Unterstützte Signaturtypen variieren je nach Format. Die vollständige Formatmatrix finden Sie in der Dokumentation.

Schnellstart

API-Anmeldeinformationen abrufen

Um GroupDocs.Signature Cloud zu nutzen, registrieren Sie sich im GroupDocs.Cloud Dashboard und holen Sie sich Ihre Client ID und Client Secret.

API initialisieren

Verwenden Sie den folgenden Code, um mit dem GroupDocs.Signature Cloud SDK für Python zu beginnen:

import groupdocs_signature_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create API configuration
configuration = groupdocs_signature_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the Sign API
sign_api = groupdocs_signature_cloud.SignApi.from_config(configuration)

Dokument mit Textsignatur signieren

Nach der Initialisierung können Sie mit diesem einfachen Beispiel eine Textsignatur zu einem Word-Dokument hinzufügen:

import groupdocs_signature_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

sign_api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/one-page.docx"

opts = groupdocs_signature_cloud.SignTextOptions()
opts.signature_type = "Text"
opts.text = "GroupDocs.Signature Cloud"
opts.left = 100
opts.top = 100
opts.width = 100
opts.height = 100
opts.page = 1

settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.file_info = file_info
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "signaturedocs/signedTextOne_page.docx"

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = sign_api.create_signatures(request)

print("Succeeded count: " + str(len(response.succeeded)))

Mit dieser Schnellstartanleitung sind Sie bereit, Dokumente mit GroupDocs.Signature Cloud in Ihren Python-Anwendungen zu signieren. Weitere Details finden Sie in der Dokumentation.

Unterstützte Dateiformate abrufen

Rufen Sie die vollständige Liste der über die Signature API verfügbaren unterstützten Dateiformate ab.

import groupdocs_signature_cloud

info_api = groupdocs_signature_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

result = info_api.get_supported_file_formats()

for fmt in result.formats:
    print(fmt.file_format)

Dokument mit digitaler Signatur signieren

Wenden Sie ein digitales Zertifikat auf ein Dokument an, für sichere, manipulationssichere Signierung.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/one-page.docx"

opts = groupdocs_signature_cloud.SignDigitalOptions()
opts.signature_type = "Digital"
opts.image_file_path = "signaturedocs/signature.jpg"
opts.certificate_file_path = "signaturedocs/temp.pfx"
opts.password = "1234567890"
opts.left = 100
opts.top = 100
opts.width = 200
opts.height = 100
opts.page = 1

settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.file_info = file_info
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "signaturedocs/signedDigitalOne_page.docx"

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = sign_api.create_signatures(request)

print("Succeeded count: " + str(len(response.succeeded)))

Nach Barcode-Signaturen suchen

Durchsuchen Sie ein signiertes Dokument nach Barcode-Signaturen und rufen Sie passende Signaturdetails ab.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/signedBarcodeOne_page.docx"

opts = groupdocs_signature_cloud.SearchBarcodeOptions()
opts.signature_type = "Barcode"
opts.page = 1

settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = file_info

request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = sign_api.search_signatures(request)

print("Signatures found: " + str(len(response.signatures)))

Textsignatur verifizieren

Überprüfen Sie, dass eine Textsignatur mit dem erwarteten Inhalt in einem signierten Dokument vorhanden ist.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/signedTextOne_page.docx"

opts = groupdocs_signature_cloud.VerifyTextOptions()
opts.signature_type = "Text"
opts.text = "GroupDocs.Signature Cloud"
opts.match_type = "Contains"
opts.page = 1

settings = groupdocs_signature_cloud.VerifySettings()
settings.options = [opts]
settings.file_info = file_info

request = groupdocs_signature_cloud.VerifySignaturesRequest(settings)
response = sign_api.verify_signatures(request)

print("IsSuccess: " + str(response.is_success))

Dokument mit Barcode-Signatur signieren

Fügen Sie eine Barcode-Signatur mit anpassbarem Erscheinungsbild und Codierung zu einem Dokument hinzu.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/one-page.docx"

opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = "Barcode"
opts.text = "123456789012"
opts.barcode_type = "Code128"
opts.left = 100
opts.top = 100
opts.width = 300
opts.height = 100
opts.page = 1

settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.file_info = file_info
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "signaturedocs/signedBarcodeOne_page.docx"

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = sign_api.create_signatures(request)

print("Succeeded count: " + str(len(response.succeeded)))

Beispielprojekte auf GitHub

Das Repository GroupDocs.Signature Cloud Python Samples enthält sofort ausführbare Beispiele für:

Beispiele ausführen

1. Klonen oder laden Sie das Beispiel-Repository herunter
2. Bearbeiten Sie RunExamples.py und setzen Sie Ihre client_id und client_secret
3. Wechseln Sie in das Verzeichnis Examples
4. Führen Sie pip install groupdocs-signature-cloud -U aus
5. Führen Sie python RunExamples.py aus

Für weitere Details besuchen Sie Getting Started.

Tags

eSignature API | Python Cloud API | GroupDocs.Signature Cloud | REST API | Digital Signature | Text Signature | Barcode Signature | QR-Code Signature | Document Signing | Signature Verification | Signature Search | Cloud Storage Integration | File Operations | Folder Operations | Secure API Access | PDF Signing | Word Document Signing | Image Signature | Stamp Signature | Cross-platform API | Document Security | Electronic Signature