يمكنك توقيع مستندات PDF الخاصة بك إلكترونيًا باستخدام رمز الاستجابة السريعة برمجيًا على السحابة. توفر التوقيعات الرقمية نفس المكانة القانونية للتوقيع بخط اليد طالما أنه يلتزم بمتطلبات اللوائح المحددة. ستركز هذه المقالة على كيفية توقيع مستندات PDF باستخدام QR Code باستخدام واجهة برمجة تطبيقات REST في Python.

سيتم تناول الموضوعات التالية في هذه المقالة:

وثيقة التوقيع REST API و Python SDK

groupdocssignature-for-cloud

للتوقيع الإلكتروني PDF ، سأستخدم Python SDK of GroupDocs.Signature Cloud API. يمكّنك من إنشاء أنواع مختلفة من التوقيعات والتحقق منها والبحث فيها في مستندات وجداول بيانات وعروض تقديمية وصور محمولة أو بسيطة لتنسيقات الملفات المدعومة. كما أنها توفر حزم SDK لـ NET و Java و PHP و Android و Ruby و Node.js باعتبارها أعضاء عائلة توقيع المستندات لواجهة برمجة التطبيقات السحابية.

يمكنك تثبيت GroupDocs.Signature Cloud على مشروع Python الخاص بك باستخدام pip (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 في Python

يمكنك توقيع مستندات PDF باستخدام QR Code باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل المستند

بادئ ذي بدء ، قم بتحميل مستند PDF إلى السحابة باستخدام مثال الرمز الوارد أدناه:

# تهيئة 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 Code باستخدام Python

يرجى اتباع الخطوات المذكورة أدناه للتوقيع على ملف 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 باستخدام رمز الاستجابة السريعة

قم بتوقيع مستندات PDF باستخدام رمز الاستجابة السريعة

قم بتنزيل الملف الموقّع

نموذج الكود أعلاه سيحفظ ملف 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\\")

تحقق من التوقيعات الإلكترونية باستخدام Python

يرجى اتباع الخطوات المذكورة أدناه للتحقق من التوقيعات من مستند PDF موقع برمز الاستجابة السريعة QR Code برمجيًا.

  • قم بإنشاء مثيل 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 المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/signature/pdf

خاتمة

في هذه المقالة ، تعلمت كيفية توقيع مستندات PDF على السحابة باستخدام وثيقة Signature REST API باستخدام Python. لقد تعلمت أيضًا كيفية تحميل ملف PDF برمجيًا على السحابة ثم تنزيل الملف الموقّع من السحابة. يمكنك معرفة المزيد حول GroupDocs.Signature Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا