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

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

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

groupdocssignature-for-cloud

برای امضای الکترونیکی PDF، من از Python SDK of GroupDocs.Signature Cloud API استفاده خواهم کرد. این به شما امکان می‌دهد انواع مختلف امضاها را در اسناد، صفحات گسترده، ارائه‌ها، و تصاویر قابل حمل یا ساده برای فرمت‌های فایل پشتیبانی شده ایجاد، تأیید و جستجو کنید. همچنین 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 را با کد QR با دنبال کردن مراحل ساده زیر امضا کنید:

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

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

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

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

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

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

لطفا مراحل ذکر شده در زیر را برای امضای برنامه نویسی فایل PDF دنبال کنید.

  • یک نمونه از SignApi ایجاد کنید
  • مسیر فایل PDF را تنظیم کنید
  • SignQRCodeOptions را تعریف کنید
  • نوع امضا، متن و کد را تنظیم کنید
  • موقعیت امضا را تنظیم کنید
  • SignSettings را تعریف کنید
  • SignQRCodeOptions و SaveOptions را به SignSettings اختصاص دهید
  • CreateSignaturesRequest را ایجاد کنید
  • با فراخوانی روش SignApi.create\signatures() به نتیجه برسید

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

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

fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "sample.pdf"

opts = groupdocs_signature_cloud.SignQRCodeOptions()
opts.signature_type = 'QRCode'
opts.text = 'GroupDocs.Signature Cloud'
opts.qr_code_type = 'Aztec'

# تنظیم موقعیت امضا در یک صفحه
opts.left = 450
opts.top = 0
opts.width = 90
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\\signedQRCode_sample.pdf"
settings.file_info = fileInfo

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
اسناد PDF را با کد QR امضا کنید

اسناد PDF را با کد QR امضا کنید

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

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

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

request = groupdocs_signature_cloud.DownloadFileRequest("Output\\signedQRCode_sample.pdf", my_storage)
response = file_api.download_file(request)

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

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

لطفاً مراحل ذکر شده در زیر را دنبال کنید تا امضاهای یک سند PDF امضا شده با کد QR را به صورت برنامه‌نویسی تأیید کنید.

  • یک نمونه از SignApi ایجاد کنید
  • مسیر فایل PDF را تنظیم کنید
  • VerifyQRCodeOptions را تعریف کنید
  • نوع، متن و کد امضا را ارائه دهید
  • VerifySettings را تعریف کنید
  • VerifyQRCodeOptions و FileInfo را به VerifySettings اختصاص دهید
  • VerifySignatureRequest را ایجاد کنید
  • با فراخوانی روش SignApi.verify\signatures() نتایج را دریافت کنید

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

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

fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "Output\\signedQRCode_sample.pdf"

opts = groupdocs_signature_cloud.VerifyQRCodeOptions()
opts.signature_type = 'QRCode'
opts.text = 'GroupDocs.Signature Cloud'
opts.qr_code_type = 'Aztec'
opts.match_type = 'Contains'

opts.page = 1

settings = groupdocs_signature_cloud.VerifySettings()
settings.options = [opts]
settings.file_info = fileInfo

request = groupdocs_signature_cloud.VerifySignaturesRequest(settings)
response = api.verify_signatures(request)

print('Signature Verified: ' + str(response.is_success))

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

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

نتیجه

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

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