Elektronik imzalar, elektronik belgelere girilen bir isim kadar basittir. Bunlar, e-ticarette ve düzenleyici dosyalamalarda giderek daha fazla kullanılmaktadır. E-imzalar, imza sahibi tarafından belgeleri elektronik olarak imzalamak için kullanılan görsel olarak kodlanmış formdaki verileri temsil eder. Bir Python geliştiricisi olarak imzalı PDF belgelerinizdeki imzaları elektronik olarak bulutta programlı olarak düzenleyebilirsiniz. Bu makale, Python’da bir REST API kullanarak imzalı PDF belgelerindeki imzaların nasıl düzenleneceğine odaklanacaktır.
Bu yazıda aşağıdaki konular ele alınacaktır:
- Belge İmzası REST API ve Python SDK
- Bir REST API kullanarak İmzalanmış PDF Belgelerindeki İmzaları Düzenleyin
- Python Kullanarak E-İmzaları Arayın ve Değiştirin
Belge İmzası REST API ve Python SDK
Bir PDF belgesindeki e-imzaları düzenlemek için GroupDocs.Signature Cloud’un Python SDK API’sini kullanacağım. Metin, damga, QR kodu, barkod, resim ve dijital imzalar uygulayarak desteklenen dosya biçimleri için belgeleri ve görüntüleri elektronik olarak korumanıza olanak tanır. Ayrıca farklı imza türlerini kolayca oluşturabilir, doğrulayabilir, silebilir ve arayabilirsiniz. Ayrıca Cloud API için belge imza ailesi üyeleri olarak .NET, Java, PHP, Android, Ruby ve Node.js SDK’ları sağlar.
Konsolda aşağıdaki komutu kullanarak GroupDocs.Signature Cloud’u Python projenize pip (python için paket yükleyici) ile yükleyebilirsiniz:
pip install groupdocs_signature_cloud
Lütfen adımları ve mevcut kod örneklerini izlemeye başlamadan önce gösterge tablosundan İstemci Kimliğinizi ve İstemci Sırrınızı alın. Kimliğinizi ve sırrınızı aşağıda gösterildiği gibi koda ekleyin:
client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
configuration = groupdocs_signature_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
Python’da bir REST API kullanarak İmzalı PDF Belgelerindeki İmzaları Düzenleyin
Aşağıda belirtilen basit adımları izleyerek imzalı PDF belgelerindeki imzaları düzenleyebilirsiniz:
- İmzalı PDF dosyalarını Buluta Yükle
- Python kullanarak İmzalı PDF Belgelerindeki İmzaları Güncelleyin
- Ortaya çıkan dosyayı İndir
Belgeyi Yükle
Öncelikle imzalı PDF belgesini aşağıda verilen kod örneğini kullanarak Buluta yükleyin:
# api başlatma
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
# örnek dosyaları yükle
request = groupdocs_signature_cloud.UploadFileRequest("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)
Sonuç olarak, yüklenen PDF dosyası (signed.pdf) bulut üzerindeki kontrol panelinizin dosyalar bölümünde mevcut olacaktır.
İmzalı PDF Belgelerindeki İmzaları Python Kullanarak Güncelleyin
İmzalı bir PDF dosyasındaki imzaları aşağıda belirtilen adımları izleyerek programlı olarak güncelleyebilirsiniz.
- Bir SignApi örneği oluşturun
- İmzalı PDF dosyasının yolunu ayarla
- SearchQRCodeOptions ve SearchSettings sağlayarak QR Kodunu arayın
- Arama İmza İsteği Oluştur
- SignApi.search\signatures() yöntemini çağırarak sonuçları alın
- UpdateOptions’ı tanımlayın
- Güncelleme Ayarlarını Ayarla
- UpdateSettings’e UpdateOptions atama
- UpdateSignaturesRequest oluşturun
- SignApi.update\signatures() yöntemini çağırarak sonuçları alın
Aşağıdaki kod parçacığı, bir REST API kullanarak imzalı bir PDF belgesindeki QR Kodu imzalarının nasıl güncelleneceğini gösterir.
# api başlatma
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# imzalı belge yolu
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# qr kodunu ara
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# qr kodunu güncelle
opts = groupdocs_signature_cloud.UpdateOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
opts.left = 450
opts.top = 600
opts.width = 90
opts.height = 90
opts.is_signature = True
settings = groupdocs_signature_cloud.UpdateSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.UpdateSignaturesRequest(settings)
response = api.update_signatures(request)
İmzalı Dosyayı İndirin
Yukarıdaki kod örneği, aşağıdaki kod örneği kullanılarak indirilebilen güncellenmiş PDF dosyasını buluta kaydedecektir:
# api başlatma
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
request = groupdocs_signature_cloud.DownloadFileRequest("signed.pdf", my_storage)
response = file_api.download_file(request)
# İndirilen dosyayı çalışma dizininize taşıyın
shutil.move(response, "C:\\Files\\")
Python Kullanarak E-İmzaları Arayın ve Değiştirin
İmzalı bir PDF belgesindeki imzaları, aşağıda verilen adımları izleyerek programlı olarak arayabilir ve değiştirebilirsiniz.
- Bir SignApi örneği oluşturun
- İmzalı PDF dosyasının yolunu ayarla
- QR Kodunu Ara
- SearchQRCodeOptions ve SearchSettings’i tanımlayın
- Arama İmza İsteği Oluştur
- SignApi.search\signatures() yöntemini çağırarak sonuçları alın
- Aranan QR Kodunu silin
- DeleteOptions ve DeleteSettings’i tanımlayın
- DeleteSignatureRequest Oluştur
- SignApi.delete\signatures() yöntemini çağırarak sonuçları alın
- Barkod ile İmzala
- SignBarcodeOptions’ı tanımlayın
- Barkod boyutunu ve konumunu ayarlayın
- SignSettings’i tanımlayın
- SignSettings’e SignBarcodeOptions ve SaveOptions atama
- CreateSignaturesRequest oluşturun
- SignApi.create\signatures() yöntemini çağırarak sonuçları alın
Aşağıdaki kod parçacığı, bir REST API kullanılarak imzalı bir PDF belgesinde QR Kod imzasının nasıl aranacağını ve bunun Barkod imzasıyla nasıl değiştirileceğini gösterir. Güncellenen dosyayı indirmek için lütfen daha önce belirtilen adımları izleyin.
# api başlatma
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# qr kod imzalı belge yolu
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# qr kodunu ara
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# qr kodunu sil
opts = groupdocs_signature_cloud.DeleteOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
settings = groupdocs_signature_cloud.DeleteSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.DeleteSignaturesRequest(settings)
response = api.delete_signatures(request)
# barkod ile imzalamak
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'
# bir sayfada barkod imza konumunu ayarlama
opts.left = 250
opts.top = 0
opts.width = 300
opts.height = 90
opts.location_measure_type = "Pixels"
opts.size_measure_type = "Pixels"
opts.stretch = "None"
opts.rotation_angle = 0
opts.horizontal_alignment = "None"
opts.vertical_alignment = "None"
opts.margin = groupdocs_signature_cloud.Padding()
opts.margin.all = 5
opts.margin_measure_type = "Pixels"
opts.inner_margins = groupdocs_signature_cloud.Padding()
opts.inner_margins.all = 2
opts.page = 1
settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "Output\\signedBarCode_sample.pdf"
settings.file_info = fileInfo
request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
Çevrimiçi Deneyin
Lütfen yukarıdaki API kullanılarak geliştirilen aşağıdaki ücretsiz çevrimiçi PDF imza aracını deneyin. https://products.groupdocs.app/signature/pdf
Çözüm
Bu makalede, imzalı PDF belgelerinde imzaların nasıl güncelleneceğini öğrendiniz. Ayrıca bulutta imzalı PDF belgelerindeki imzaları nasıl arayacağınızı ve değiştireceğinizi de öğrendiniz. Bu makale ayrıca bir PDF dosyasını programlı olarak buluta nasıl yükleyeceğinizi ve ardından imzalı dosyayı buluttan nasıl indireceğinizi de açıkladı. Belgeleri kullanarak GroupDocs.Signature Cloud API hakkında daha fazla bilgi edinebilirsiniz. Ayrıca, API’lerimizi doğrudan tarayıcı aracılığıyla görselleştirmenize ve bunlarla etkileşimde bulunmanıza olanak tanıyan bir API Referansı bölümü de sağlıyoruz. Herhangi bir belirsizlik durumunda, lütfen forumda bizimle iletişime geçmekten çekinmeyin.