Kurulum

Paket PyPI’de mevcut‘dir ve aşağıdaki komut çalıştırılarak pip aracılığıyla kurulabilir:

pip install groupdocs-signature-cloud

Gereksinimler

• Python 2,7 veya 3,4+
• pip paket yöneticisi
• GroupDocs Cloud kimlik bilgileri — Kontrol Panelinden İstemci Kimliği ve İstemci Sırrı

Bağımlılıklar

SDK aşağıdaki paketleri otomatik olarak yükler:

Belgeleri e-İmzalamak için Python Cloud REST API

GroupDocs.Signature Cloud SDK for Python, e-imzaları Python web uygulamalarına, komut dosyalarına ve otomasyon iş akışlarına entegre etmek için kapsamlı bir çözüm sunar. Word, Excel, PDF, sunum ve resim formatlarında çok çeşitli imza türlerini (metin, resim, barkod, QR kodu, dijital ve damga) destekler. Geliştiriciler imza görünümünü, yerleşimini ve güvenliğini özelleştirebilir, dijital sertifikalar uygulayabilir, imza orijinalliğini doğrulayabilir ve belgelerde mevcut imzaları arayabilir. İster tek bir sayfayı imzalayın ister bir belge koleksiyonunda birden fazla imzayı yönetin, GroupDocs.Signature, güvenli ve verimli bulut tabanlı belge imzalama için güçlü araçlar sunar.

Bulut Belge İmzalama Özellikleri

İmzaları Belirli Sayfalara Uygulayın - Hassas yerleşim için imzaları çift, tek veya belirli sayfalara uygulayın.
Sayfa Dolgusunu Yapılandır - İmzaları her sayfada tam olarak hizalamak için sayfa dolgusunu ayarlayın.
İmza Görünümünü Özelleştirin - İmzaların yazı tiplerini, renklerini ve stilini kontrol edin.
Arka Plan Kırpma Ayarlarını Uygula - İmza görünürlüğünü iyileştirmek için arka plan kırpma ayarlarını kullanın.
İmza Dizisini Tekrarla - Tanımlı alanları doldurmak için imza dizelerini tekrarlayın.
CryptoApi ve XmlDsig ile Dijital İmzalar - CryptoApi ve XmlDsig aracılığıyla dijital imzaları destekleyin.
Barkod İmzaları için Metni Hizala - Yapılandırılabilir metni kullanarak barkod imzalarını hizalayın.
Parola Korumalı Belgeleri İmzalayın - Parola korumalı belgeleri imzalayın.
Belge İmzalarını Doğrulayın - Belge imzalarının gerçekliğini ve geçerliliğini doğrulayın.
İmza Türlerini Ara - Belgelerdeki belirli imza türlerini arayın.

Gelişmiş Özellikler

İmza Görünümünü Özelleştirin - İmza yazı tiplerini, renklerini ve stilini özelleştirin.
Birden Fazla İmzayı Yönetin - Tek bir belgede birden fazla imzayı yönetin.
Belgeler için Parola Koruması - İmzalı belgelere parola koruması ekleyin.
İmza Orijinalliğini Doğrulayın - Uygulanan imzaların orijinalliğini doğrulayın.
Belirli İmzaları Ara - Metin, barkod, QR kodu ve dijital imzaları arayın.
İmzaları Güncelle ve Sil - Belgelerdeki mevcut imzaları değiştirin veya kaldırın.

Barkod ve QR Kod İmzaları

Barkod/QR İmzaları için Desteklenen Formatlar - DOC, DOCX, XLSX, PDF ve görüntü formatlarını destekler.
Barkod/QR-Kod İmzalarını Özelleştirin - Barkod/QR imzalarının görünümünü ve içeriğini özelleştirin.
Barkod/QR-Kod Kullanım Senaryoları - Kullanım örnekleri belge izleme ve tanımlamayı içerir.

Damga İmzaları

Damga İmzalarına Genel Bakış - Resmi belgeler için görsel ve metin damga imzaları.
Damga İmzalarını Özelleştirin - Damga boyutunu, metnini ve görünümünü ayarlayın.

Desteklenen İmza Türleri

Metin İmzası - Yazı tipi, renk ve hizalamayla özelleştirilebilir metin etiketleri ekleyin.
Görüntü İmzası - Görüntü imzalarını opaklık, gri tonlama, parlaklık ve kontrastla uygulayın.
Barkod İmzası - Esnek görünüme, hizalamaya ve kodlamaya sahip barkod türleri ekleyin.
QR-Kod İmzası - Özelleştirilebilir kodlama ve görünüme sahip QR-Kod imzalarını ekleyin.
Dijital İmza - Belgelere veya PDF sayfalarına dijital sertifikalar (PFX, CRT) uygulayın.
Damga İmzası - Esnek özelleştirmeyle sayfalara damga resimleri yerleştirin.

Dosya İşlemleri

Dosyaları Buluta Yükle - Dosyaları API aracılığıyla bulut depolama alanına yükleyin.
Dosyaları Buluttan İndirin - Dosyaları bulut depolama alanından yerel sistemlere indirin.
Dosyaları Kopyala - Bulut depolama alanındaki dosyaları farklı konumlara kopyalayın.
Dosyaları Taşı - Dosyaları bulut depolama alanındaki klasörler arasında taşıyın.
Dosyaları Sil - Belirli dosyaları bulut depolama alanından silin.

Klasör İşlemleri

Klasör Oluştur - Bulut depolama alanında yeni klasörler oluşturun.
Klasörü Kopyala - Bulut depolama alanındaki klasörleri çoğaltın.
Klasörü Taşı - Klasörleri bulut depolama alanındaki dizinler arasında taşıyın.
Klasörü Sil - Klasörlerin tamamını bulut depolama alanından kaldırın.

Lisanslama ve Kimlik Doğrulama

Değerlendirme Modu - API’yi ücretsiz deneme hesabıyla deneyin.
Güvenli Kimlik Doğrulama - Güvenli API erişimi için İstemci Kimliğini ve İstemci Sırrını kullanın.
MIT Lisansı - Python SDK, MIT Lisansı kapsamında lisanslanmıştır.

Desteklenen Belge Formatları

GroupDocs.Signature Cloud, aşağıdaki format kategorilerinde imzalamayı destekler:

• Kelime İşleme: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, OTT, RTF, TXT
• E-tablolar: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Sunumlar: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF: PDF
• Resimler: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF ve daha fazlası

Desteklenen imza türleri formata göre değişir. Format matrisinin tamamı için belgelere bakın.

Hızlı Başlangıç

API kimlik bilgilerinizi alın

GroupDocs.Signature Cloud’u kullanmak için, GroupDocs.Cloud Dashboard adresinden kaydolun ve Müşteri Kimliğinizi ve Müşteri Sırrınızı alın.

API’yi başlat

Python için GroupDocs.Signature Cloud SDK’yı kullanmaya başlamak için aşağıdaki kodu kullanın:

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)

Bir belgeyi metin imzasıyla imzalayın

Başlatıldıktan sonra, bir Word belgesine metin imzası eklemek için bu temel örneği kullanın:

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

Bu hızlı başlangıç ​​kılavuzuyla, Python uygulamalarınızda GroupDocs.Signature Cloud’u kullanarak belge imzalamaya başlamaya hazırsınız. Daha fazla ayrıntı için belgeleri ziyaret edin.

Desteklenen Dosya Formatlarını Alın

Signature API aracılığıyla kullanılabilen desteklenen dosya biçimlerinin tam listesini alın.

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)

Belgeyi Dijital İmzayla İmzalayın

Güvenli, kurcalanmaya karşı korumalı imzalama için bir belgeye dijital sertifika uygulayın.

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

Barkod İmzalarını Arayın

İmzalı bir belgede barkod imzalarını arayın ve eşleşen imza ayrıntılarını alın.

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

Metin İmzasını Doğrulayın

İmzalı bir belgede beklenen içeriğe sahip bir metin imzasının bulunduğunu doğrulayın.

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

Belgeyi Barkod İmzasıyla İmzalayın

Özelleştirilebilir görünüme ve kodlamaya sahip bir belgeye barkod imzası ekleyin.

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’daki Örnek Projeler

GroupDocs.Signature Cloud Python Samples deposu aşağıdakileri kapsayan çalıştırılmaya hazır örnekler içerir:

Örnekler nasıl çalıştırılır

1. örnek deposunu kopyalayın veya indirin
2. RunExamples.py‘i düzenleyin ve client_id ile client_secret ayarlarınızı yapın
3. Examples dizinine gidin
4. pip install groupdocs-signature-cloud -U‘ı çalıştırın
5. python RunExamples.py komutunu çalıştırın

Daha fazla ayrıntı için Başlarken adresini ziyaret edin.

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