Installation

Le package est disponible sur PyPI et peut être installé via pip en exécutant la commande suivante :

pip install groupdocs-signature-cloud

Prérequis

• Python 2.7 ou 3.4+
• Gestionnaire de packages pip
• Identifiants GroupDocs Cloud — Client ID et Client Secret depuis le Dashboard

Dépendances

Le SDK installe automatiquement les packages suivants :

API REST Cloud Python de signature électronique de documents

GroupDocs.Signature Cloud SDK pour Python offre une solution complète pour intégrer la signature électronique dans les applications web Python, les scripts et les flux d’automatisation. Il prend en charge un large éventail de types de signatures — texte, image, code-barres, QR-code, numérique et tampon — pour les formats Word, Excel, PDF, présentation et image. Les développeurs peuvent personnaliser l’apparence, le placement et la sécurité des signatures, appliquer des certificats numériques, vérifier l’authenticité des signatures et rechercher des signatures existantes dans les documents. Que vous signiez une seule page ou gériez plusieurs signatures dans une collection de documents, GroupDocs.Signature fournit des outils robustes pour une signature de documents cloud sécurisée et efficace.

Fonctionnalités de signature de documents cloud

Appliquer des signatures à des pages spécifiques - Appliquez des signatures sur les pages paires, impaires ou spécifiques pour un placement précis.
Configurer la marge de page - Définissez la marge de page pour aligner précisément les signatures sur chaque page.
Personnaliser l’apparence des signatures - Contrôlez les polices, les couleurs et le style des signatures.
Appliquer les paramètres de recadrage d’arrière-plan - Utilisez les paramètres de recadrage d’arrière-plan pour améliorer la visibilité des signatures.
Répéter la chaîne de signature - Répétez les chaînes de signature pour remplir des zones définies.
Signatures numériques avec CryptoApi et XmlDsig - Prise en charge des signatures numériques via CryptoApi et XmlDsig.
Aligner le texte pour les signatures code-barres - Alignez les signatures code-barres à l’aide d’un texte configurable.
Signer des documents protégés par mot de passe - Signez des documents protégés par mot de passe.
Vérifier les signatures de documents - Vérifiez l’authenticité et la validité des signatures de documents.
Rechercher des types de signatures - Recherchez des types de signatures spécifiques dans les documents.

Fonctionnalités avancées

Personnaliser l’apparence des signatures - Personnalisez les polices, les couleurs et le style des signatures.
Gérer plusieurs signatures - Gérez plusieurs signatures dans un même document.
Protection par mot de passe des documents - Ajoutez une protection par mot de passe aux documents signés.
Vérifier l’authenticité des signatures - Validez l’authenticité des signatures appliquées.
Rechercher des signatures spécifiques - Recherchez des signatures textuelles, code-barres, QR-code et numériques.
Mettre à jour et supprimer des signatures - Modifiez ou supprimez des signatures existantes dans les documents.

Signatures code-barres et QR-Code

Formats pris en charge pour les signatures code-barres/QR - Prend en charge les formats DOC, DOCX, XLSX, PDF et image.
Personnaliser les signatures code-barres/QR-Code - Personnalisez l’apparence et le contenu des signatures code-barres/QR.
Scénarios d’utilisation code-barres/QR-Code - Les cas d’utilisation incluent le suivi et l’identification de documents.

Signatures de tampon

Aperçu des signatures de tampon - Signatures de tampon visuelles et textuelles pour les documents officiels.
Personnaliser les signatures de tampon - Ajustez la taille, le texte et l’apparence du tampon.

Types de signatures pris en charge

Signature textuelle - Ajoutez des étiquettes textuelles personnalisables avec police, couleur et alignement.
Signature d’image - Appliquez des signatures d’image avec opacité, niveaux de gris, luminosité et contraste.
Signature code-barres - Ajoutez des types de codes-barres avec apparence, alignement et encodage flexibles.
Signature QR-Code - Insérez des signatures QR-Code avec encodage et apparence personnalisables.
Signature numérique - Appliquez des certificats numériques (PFX, CRT) aux documents ou aux pages PDF.
Signature de tampon - Placez des images de tampon sur les pages avec une personnalisation flexible.

Opérations sur les fichiers

Téléverser des fichiers vers le cloud - Téléversez des fichiers vers le stockage cloud via l’API.
Télécharger des fichiers depuis le cloud - Téléchargez des fichiers du stockage cloud vers les systèmes locaux.
Copier des fichiers - Copiez des fichiers dans le stockage cloud vers différents emplacements.
Déplacer des fichiers - Déplacez des fichiers entre les dossiers du stockage cloud.
Supprimer des fichiers - Supprimez des fichiers spécifiques du stockage cloud.

Opérations sur les dossiers

Créer un dossier - Créez de nouveaux dossiers dans le stockage cloud.
Copier un dossier - Dupliquez des dossiers dans le stockage cloud.
Déplacer un dossier - Déplacez des dossiers entre les répertoires du stockage cloud.
Supprimer un dossier - Supprimez des dossiers entiers du stockage cloud.

Licence et authentification

Mode d’évaluation - Essayez l’API avec un compte d’essai gratuit.
Authentification sécurisée - Utilisez Client ID et Client Secret pour un accès API sécurisé.
Licence MIT - Le SDK Python est sous licence MIT License.

Formats de fichiers pris en charge

GroupDocs.Signature Cloud prend en charge la signature pour les catégories de formats suivantes :

• Traitement de texte : DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, OTT, RTF, TXT
• Feuilles de calcul : XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Présentations : PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF : PDF
• Images : BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF, et plus encore

Les types de signatures pris en charge varient selon le format. Pour la matrice complète des formats, consultez la documentation.

Démarrage rapide

Obtenez vos identifiants API

Pour utiliser GroupDocs.Signature Cloud, inscrivez-vous sur le GroupDocs.Cloud Dashboard et obtenez votre Client ID et votre Client Secret.

Initialiser l’API

Utilisez le code suivant pour commencer à utiliser GroupDocs.Signature Cloud SDK pour 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)

Signer un document avec une signature textuelle

Une fois initialisé, utilisez cet exemple de base pour ajouter une signature textuelle à un document 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)))

Avec ce guide de démarrage rapide, vous êtes prêt à commencer à signer des documents avec GroupDocs.Signature Cloud dans vos applications Python. Pour plus de détails, consultez la documentation.

Obtenir les formats de fichiers pris en charge

Récupérez la liste complète des formats de fichiers pris en charge via la 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)

Signer un document avec une signature numérique

Appliquez un certificat numérique à un document pour une signature sécurisée et inviolable.

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

Rechercher des signatures code-barres

Recherchez des signatures code-barres dans un document signé et récupérez les détails des signatures correspondantes.

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

Vérifier une signature textuelle

Vérifiez qu’une signature textuelle avec le contenu attendu existe dans un document signé.

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

Signer un document avec une signature code-barres

Ajoutez une signature code-barres à un document avec apparence et encodage personnalisables.

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

Projets d’exemple sur GitHub

Le dépôt GroupDocs.Signature Cloud Python Samples inclut des exemples prêts à l’emploi couvrant :

Comment exécuter les exemples

1. Clonez ou téléchargez le dépôt d’exemples
2. Modifiez RunExamples.py et définissez votre client_id et client_secret
3. Accédez au répertoire Examples
4. Exécutez pip install groupdocs-signature-cloud -U
5. Exécutez python RunExamples.py

Pour plus de détails, consultez 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