Εγκατάσταση

Το πακέτο είναι available στο PyPI και μπορεί να εγκατασταθεί μέσω pip εκτελώντας την παρακάτω εντολή:

pip install groupdocs-signature-cloud

Απαιτήσεις

• Python 2.7 ή 3.4+
• pip διαχειριστής πακέτων
• Διαπιστευτήρια GroupDocs Cloud —Client ID and Client Secret από τον πίνακα ελέγχου

Εξαρτήσεις

Το SDK εγκαθιστά αυτόματα τα ακόλουθα πακέτα:

Python Cloud REST API για eSigning Documents

GroupDocs.Signature Cloud SDK for Python παρέχει μια ολοκληρωμένη λύση για την ενσωμάτωση ηλεκτρονικών υπογραφών σε εφαρμογές web Python, σενάρια και ροές εργασίας αυτοματισμού. Υποστηρίζει ένα ευρύ φάσμα τύπων υπογραφών — κείμενο, εικόνα, γραμμωτός κώδικας, QR-code, ψηφιακός και σφραγίδα — σε μορφές Word, Excel, PDF, παρουσίασης και εικόνας. Οι προγραμματιστές μπορούν να προσαρμόσουν την εμφάνιση, την τοποθέτηση και την ασφάλεια της υπογραφής, να εφαρμόσουν ψηφιακά πιστοποιητικά, να επαληθεύσουν τη γνησιότητα της υπογραφής και να αναζητήσουν υπάρχουσες υπογραφές στα έγγραφα. Είτε υπογράφετε μια μεμονωμένη σελίδα είτε διαχειρίζεστε πολλές υπογραφές σε μια συλλογή εγγράφων, το GroupDocs.Signature παρέχει ισχυρά εργαλεία για ασφαλή και αποτελεσματική υπογραφή εγγράφων που βασίζεται στο cloud.

Δυνατότητες υπογραφής εγγράφων cloud

Εφαρμογή υπογραφών σε συγκεκριμένες σελίδες - Εφαρμόστε υπογραφές σε ζυγές, μονές ή συγκεκριμένες σελίδες για ακριβή τοποθέτηση.
Διαμόρφωση συμπλήρωσης σελίδων - Ρυθμίστε τη συμπλήρωση σελίδων ώστε να ευθυγραμμίζονται με ακρίβεια οι υπογραφές σε κάθε σελίδα.
Προσαρμογή εμφάνισης υπογραφής - Ελέγξτε τις γραμματοσειρές, τα χρώματα και το στυλ των υπογραφών.
Εφαρμογή ρυθμίσεων περικοπής φόντου - Χρησιμοποιήστε τις ρυθμίσεις περικοπής φόντου για να βελτιώσετε την ορατότητα της υπογραφής.
Επανάληψη συμβολοσειράς υπογραφής - Επαναλάβετε τις συμβολοσειρές υπογραφής για να γεμίσετε καθορισμένες περιοχές.
Ψηφιακές υπογραφές με CryptoApi & XmlDsig - Υποστήριξη ψηφιακών υπογραφών μέσω CryptoApi και XmlDsig.
Στοίχιση κειμένου για υπογραφές γραμμικού κώδικα - Ευθυγραμμίστε τις υπογραφές γραμμικού κώδικα χρησιμοποιώντας κείμενο με δυνατότητα διαμόρφωσης.
Υπογραφή εγγράφων που προστατεύονται με κωδικό πρόσβασης - Υπογράψτε έγγραφα που προστατεύονται με κωδικό πρόσβασης.
Επαλήθευση υπογραφών εγγράφων - Επαληθεύστε τη γνησιότητα και την εγκυρότητα των υπογραφών εγγράφων.
Αναζήτηση για τύπους υπογραφών - Αναζήτηση για συγκεκριμένους τύπους υπογραφών εντός εγγράφων.

Προηγμένες δυνατότητες

Προσαρμογή εμφάνισης υπογραφής - Προσαρμόστε γραμματοσειρές, χρώματα και στυλ υπογραφής.
Διαχείριση πολλαπλών υπογραφών - Χειριστείτε πολλές υπογραφές σε ένα έγγραφο.
Προστασία με κωδικό πρόσβασης για έγγραφα - Προσθέστε προστασία με κωδικό πρόσβασης σε υπογεγραμμένα έγγραφα.
Επαλήθευση γνησιότητας υπογραφής - Επικύρωση γνησιότητας των εφαρμοζόμενων υπογραφών.
Αναζήτηση για συγκεκριμένες υπογραφές - Αναζήτηση για κείμενο, γραμμωτό κώδικα, κώδικα QR και ψηφιακές υπογραφές.
Ενημέρωση και διαγραφή υπογραφών - Τροποποίηση ή κατάργηση υπαρχουσών υπογραφών από έγγραφα.

Υπογραφές γραμμωτού κώδικα και QR-Code

Υποστηριζόμενες μορφές για υπογραφές Barcode/QR - Υποστηρίζει μορφές DOC, DOCX, XLSX, PDF και εικόνας.
Προσαρμογή υπογραφών Barcode/QR-Code - Προσαρμόστε την εμφάνιση και το περιεχόμενο των υπογραφών barcode/QR.
Σενάρια χρήσης Barcode/QR-Code - Οι περιπτώσεις χρήσης περιλαμβάνουν παρακολούθηση και αναγνώριση εγγράφων.

Υπογραφές σφραγίδας

Επισκόπηση των υπογραφών σφραγίδας - Υπογραφές σφραγίδων οπτικής και κειμένου για επίσημα έγγραφα.
Προσαρμογή υπογραφών σφραγίδας - Προσαρμόστε το μέγεθος, το κείμενο και την εμφάνιση σφραγίδας.

Υποστηριζόμενοι τύποι υπογραφών

Υπογραφή κειμένου - Προσθέστε προσαρμόσιμες ετικέτες κειμένου με γραμματοσειρά, χρώμα και στοίχιση.
Υπογραφή εικόνας - Εφαρμόστε υπογραφές εικόνας με αδιαφάνεια, κλίμακα του γκρι, φωτεινότητα και αντίθεση.
Υπογραφή γραμμικού κώδικα - Προσθέστε τύπους γραμμωτού κώδικα με ευέλικτη εμφάνιση, ευθυγράμμιση και κωδικοποίηση.
Υπογραφή QR-Code - Εισαγάγετε υπογραφές QR-Code με προσαρμόσιμη κωδικοποίηση και εμφάνιση.
Ψηφιακή υπογραφή - Εφαρμόστε ψηφιακά πιστοποιητικά (PFX, CRT) σε έγγραφα ή σελίδες PDF.
Υπογραφή σφραγίδας - Τοποθετήστε εικόνες σφραγίδας σε σελίδες με ευέλικτη προσαρμογή.

Λειτουργίες αρχείων

Μεταφόρτωση αρχείων στο Cloud - Μεταφόρτωση αρχείων στο χώρο αποθήκευσης cloud μέσω του API.
Λήψη Αρχείων από το Cloud - Λήψη αρχείων από την αποθήκευση cloud σε τοπικά συστήματα.
Αντιγραφή αρχείων - Αντιγραφή αρχείων εντός του χώρου αποθήκευσης cloud σε διαφορετικές τοποθεσίες.
Μετακίνηση αρχείων - Μετακίνηση αρχείων μεταξύ φακέλων στο χώρο αποθήκευσης cloud.
Διαγραφή αρχείων - Διαγράψτε συγκεκριμένα αρχεία από την αποθήκευση στο cloud.

Λειτουργίες φακέλου

Δημιουργία φακέλου - Δημιουργήστε νέους φακέλους στο χώρο αποθήκευσης cloud.
Αντιγραφή φακέλου - Διπλότυποι φάκελοι εντός του αποθηκευτικού χώρου cloud.
Μετακίνηση φακέλου - Μετακίνηση φακέλων μεταξύ καταλόγων στο χώρο αποθήκευσης cloud.
Διαγραφή φακέλου - Καταργήστε ολόκληρους φακέλους από την αποθήκευση στο cloud.

Αδειοδότηση και έλεγχος ταυτότητας

Λειτουργία αξιολόγησης - Δοκιμάστε το API με έναν δωρεάν δοκιμαστικό λογαριασμό.
Ασφαλής έλεγχος ταυτότητας - Χρησιμοποιήστε το Client ID και το Client Secret για ασφαλή πρόσβαση στο API.
Άδεια MIT - Το Python SDK έχει άδεια χρήσης σύμφωνα με το MIT License.

Υποστηριζόμενες μορφές εγγράφων

Το GroupDocs.Signature Cloud υποστηρίζει την υπογραφή στις ακόλουθες κατηγορίες μορφών:

• Επεξεργασία κειμένου: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, OTT, RTF, TXT
• Υπολογιστικά φύλλα: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Παρουσιάσεις: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF: PDF
• Εικόνες: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF και άλλα

Οι υποστηριζόμενοι τύποι υπογραφών διαφέρουν ανάλογα με τη μορφή. Για την πλήρη μήτρα μορφής, δείτε το documentation.

Γρήγορη εκκίνηση

Λάβετε τα διαπιστευτήρια API σας

Για να χρησιμοποιήσετε το GroupDocs.Signature Cloud, εγγραφείτε στο GroupDocs.Cloud Dashboard και λάβετε το Client ID και το Client Secret.

Εκκινήστε το API

Χρησιμοποιήστε τον ακόλουθο κώδικα για να ξεκινήσετε να χρησιμοποιείτε το GroupDocs.Signature Cloud SDK για Python:

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)

Υπογράψτε ένα έγγραφο με υπογραφή κειμένου

Μόλις αρχικοποιηθεί, χρησιμοποιήστε αυτό το βασικό παράδειγμα για να προσθέσετε μια υπογραφή κειμένου σε ένα έγγραφο του Word:

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)))

Με αυτόν τον οδηγό γρήγορης εκκίνησης, είστε έτοιμοι να αρχίσετε να υπογράφετε έγγραφα χρησιμοποιώντας το GroupDocs.Signature Cloud στις εφαρμογές σας Python. Για περισσότερες λεπτομέρειες, επισκεφθείτε το documentation.

Λάβετε υποστηριζόμενες μορφές αρχείων

Ανακτήστε την πλήρη λίστα των υποστηριζόμενων μορφών αρχείων που είναι διαθέσιμες μέσω του Signature API.

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)

Υπογραφή εγγράφου με ψηφιακή υπογραφή

Εφαρμόστε ένα ψηφιακό πιστοποιητικό σε ένα έγγραφο για ασφαλή, προφανή υπογραφή.

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)))

Αναζήτηση για υπογραφές γραμμωτού κώδικα

Αναζητήστε ένα υπογεγραμμένο έγγραφο για υπογραφές γραμμωτού κώδικα και ανακτήστε τις αντίστοιχες λεπτομέρειες υπογραφής.

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)))

Επαληθεύστε την υπογραφή κειμένου

Βεβαιωθείτε ότι υπάρχει μια υπογραφή κειμένου με το αναμενόμενο περιεχόμενο σε ένα υπογεγραμμένο έγγραφο.

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))

Υπογράψτε έγγραφο με υπογραφή γραμμικού κώδικα

Προσθέστε μια υπογραφή γραμμικού κώδικα σε ένα έγγραφο με προσαρμόσιμη εμφάνιση και κωδικοποίηση.

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)))

Δείγματα έργων στο GitHub

Ο GroupDocs.Signature Cloud Python Samples το αποθετήριο περιλαμβάνει έτοιμα προς εκτέλεση παραδείγματα που καλύπτουν:

Πώς να εκτελέσετε τα παραδείγματα

1. Κλωνοποιήστε ή κατεβάστε το samples repository2. Επεξεργασία RunExamples.py και ρυθμίστε το δικό σας client_id και client_secret3. Πηγαίνετε στο Examples καταλόγου
2. Τρέξε pip install groupdocs-signature-cloud -U5. Εκτελέστε python RunExamples.py

Για περισσότερες λεπτομέρειες, επισκεφθείτε Getting Started.

Ετικέτες

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