امضای الکترونیکی به سادگی نامی است که در اسناد الکترونیکی وارد شده است. اینها به طور فزاینده ای در تجارت الکترونیک و در پرونده های نظارتی استفاده می شوند. امضای الکترونیکی داده ها را به شکل رمزگذاری شده بصری نشان می دهد که توسط امضاکننده برای امضای الکترونیکی اسناد استفاده می شود. به‌عنوان یک توسعه‌دهنده پایتون، می‌توانید امضاها را در اسناد PDF امضاشده خود به‌صورت برنامه‌نویسی در ابر ویرایش کنید. این مقاله بر نحوه ویرایش امضاها در اسناد PDF امضا شده با استفاده از REST API در پایتون تمرکز خواهد کرد.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

امضای سند REST API و Python SDK

groupdocssignature-for-cloud

برای ویرایش امضاهای الکترونیکی در یک سند PDF، من از Python SDK of GroupDocs.Signature Cloud API استفاده خواهم کرد. این شما را قادر می سازد تا اسناد و تصاویر را به صورت الکترونیکی برای فرمت های فایل پشتیبانی شده با اعمال متن، مهر، کد QR، بارکد، تصویر و امضای دیجیتال ایمن کنید. همچنین می توانید انواع مختلف امضاها را به راحتی ایجاد، تأیید، حذف و جستجو کنید. همچنین SDK های دات نت، جاوا، PHP، اندروید، روبی و Node.js را به عنوان [اعضای خانواده امضای سند3 برای Cloud API ارائه می کند.

می‌توانید با استفاده از دستور زیر در کنسول، GroupDocs.Signature Cloud را با پیپ (package installer for python) در پروژه پایتون خود نصب کنید:

pip install groupdocs_signature_cloud

لطفاً قبل از شروع به دنبال کردن مراحل و نمونه کدهای موجود، شناسه مشتری و راز مشتری خود را از داشبورد دریافت کنید. شناسه و راز خود را به شکل زیر در کد اضافه کنید:

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 = ""

امضاها را در اسناد PDF امضا شده با استفاده از REST API در پایتون ویرایش کنید

می توانید امضاها را در اسناد PDF امضا شده با دنبال کردن مراحل ساده زیر ویرایش کنید:

سند را آپلود کنید

اول از همه، سند PDF امضا شده را با استفاده از نمونه کد زیر در Cloud آپلود کنید:

# مقداردهی اولیه api
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)

# فایل های نمونه را آپلود کنید
request = groupdocs_signature_cloud.UploadFileRequest("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)

در نتیجه، فایل PDF آپلود شده (signed.pdf) در بخش فایل ها داشبورد شما در فضای ابری در دسترس خواهد بود.

امضاها را در اسناد PDF امضا شده با استفاده از پایتون به روز کنید

با دنبال کردن مراحل ذکر شده در زیر می توانید امضاهای موجود در یک فایل PDF امضا شده را به صورت برنامه ای به روز کنید.

  • یک نمونه از SignApi ایجاد کنید
  • مسیر فایل PDF امضا شده را تنظیم کنید
  • با ارائه SearchQRCodeOptions و Search Settings کد QR را جستجو کنید
  • SearchSignatureRequest را ایجاد کنید
  • با فراخوانی روش SignApi.search\signatures() به نتیجه برسید
  • UpdateOptions را تعریف کنید
  • تنظیمات Update را تنظیم کنید
  • UpdateOptions را به UpdateSettings اختصاص دهید
  • UpdateSignaturesRequest را ایجاد کنید
  • با فراخوانی روش SignApi.update\signatures() نتایج را دریافت کنید

قطعه کد زیر نحوه به‌روزرسانی امضاهای کد QR را در یک سند PDF امضا شده با استفاده از REST API نشان می‌دهد.

# مقداردهی اولیه api
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

# مسیر سند امضا شده
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"

# کد qr را جستجو کنید
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 را به روز کنید
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)
امضاها را در سند PDF امضا شده با استفاده از پایتون به روز کنید

امضاها را در سند PDF امضا شده با استفاده از پایتون به روز کنید

فایل امضا شده را دانلود کنید

نمونه کد بالا فایل PDF به روز شده را در فضای ابری ذخیره می کند که با استفاده از نمونه کد زیر قابل دانلود است:

# مقداردهی اولیه api
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)

request = groupdocs_signature_cloud.DownloadFileRequest("signed.pdf", my_storage)
response = file_api.download_file(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\")

جستجو و جایگزینی امضاهای الکترونیکی با استفاده از پایتون

می توانید با دنبال کردن مراحل زیر، امضاها را در یک سند PDF امضا شده به صورت برنامه نویسی جستجو و جایگزین کنید.

  • یک نمونه از SignApi ایجاد کنید
  • مسیر فایل PDF امضا شده را تنظیم کنید
  • کد QR را جستجو کنید
    • SearchQRCodeOptions و Search Settings را تعریف کنید
    • SearchSignatureRequest را ایجاد کنید
    • با فراخوانی روش SignApi.search\signatures() به نتیجه برسید
  • کد QR جستجو شده را حذف کنید
    • DeleteOptions و DeleteSettings را تعریف کنید
    • DeleteSignatureRequest را ایجاد کنید
    • با فراخوانی روش SignApi.delete\signatures() به نتیجه برسید
  • با بارکد امضا کنید
    • SignBarcodeOptions را تعریف کنید
    • اندازه و موقعیت بارکد را تنظیم کنید
    • SignSettings را تعریف کنید
    • SignBarcodeOptions و SaveOptions را به SignSettings اختصاص دهید
    • CreateSignaturesRequest را ایجاد کنید
    • با فراخوانی روش SignApi.create\signatures() به نتیجه برسید

قطعه کد زیر نحوه جستجوی امضای کد QR و جایگزینی آن با امضای بارکد را در یک سند PDF امضا شده با استفاده از REST API نشان می‌دهد. لطفاً برای دانلود فایل به روز شده مراحل ذکر شده را دنبال کنید.

# مقداردهی اولیه api
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

# مسیر سند امضا شده با کد qr
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"

# کد qr را جستجو کنید
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 را حذف کنید
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)

# با بارکد امضا کنید
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'

# تنظیم موقعیت امضای بارکد در یک صفحه
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)
جستجو و جایگزینی امضاها در سند PDF امضا شده با استفاده از پایتون

جستجو و جایگزینی امضاها در سند PDF امضا شده با استفاده از پایتون

آنلاین را امتحان کنید

لطفاً ابزار آنلاین رایگان امضای PDF زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/signature/pdf

نتیجه

در این مقاله نحوه به روز رسانی امضا در اسناد PDF امضا شده را یاد گرفتید. همچنین یاد گرفتید که چگونه امضاها را در اسناد PDF امضا شده در ابر جستجو و جایگزین کنید. در این مقاله همچنین نحوه آپلود برنامه‌نویسی یک فایل PDF بر روی ابر و سپس دانلود فایل امضا شده از ابر توضیح داده شده است. می‌توانید با استفاده از مستندات درباره GroupDocs.Signature Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس بگیرید17.

همچنین ببینید