ما هو التوقيع الالكتروني؟
يشير التوقيع الإلكتروني أو التوقيع الإلكتروني إلى البيانات الموجودة في شكل إلكتروني والتي ترتبط منطقيًا ببيانات أخرى في شكل إلكتروني والتي يستخدمها الموقّع للتوقيع. يوفر هذا النوع من التوقيع نفس المكانة القانونية للتوقيع بخط اليد طالما أنه يلتزم بمتطلبات اللائحة المحددة. يمكن أن تكون التوقيعات الإلكترونية في شكل نص رقمي ، وصور ، وباركود ، ورموز QR ، إلخ.
التوقيعات الإلكترونية هي مفهوم قانوني متميز عن التوقيعات الرقمية ، وهي آلية تشفير تستخدم غالبًا لتنفيذ التوقيعات الإلكترونية. في حين أن التوقيع الإلكتروني يمكن أن يكون بسيطًا مثل الاسم الذي يتم إدخاله في مستند إلكتروني ، فإن التوقيعات الرقمية تستخدم بشكل متزايد في التجارة الإلكترونية وفي الإيداعات التنظيمية لتنفيذ التوقيعات الإلكترونية بطريقة محمية بالتشفير.
GroupDocs.Signature Cloud API؟
GroupDocs.Signature Cloud هي واجهة برمجة تطبيقات REST لإنشاء أنواع مختلفة من كائنات التوقيع والتحقق منها والبحث عنها في المستندات الموجودة في السحابة. هناك خمسة أنواع رئيسية من Signature المدعومة التي يمكنك العمل بها:
- توقيع النص
- توقيع الباركود
- توقيع رمز الاستجابة السريعة
- توقيع إلكتروني
- توقيع الصورة
- توقيع الطوابع
كيف تعمل مع وثيقة الباركود باستخدام واجهة برمجة التطبيقات للتوقيع الإلكتروني؟
تهدف واجهة برمجة التطبيقات هذه إلى إضافة توقيعات إلكترونية إلى المستندات ، بناءً على المعلمات التي تم تمريرها كمجموعة من خيارات التوقيع. يمكن تنزيل المستند الذي تم تقديمه باستخدام عناوين URL الإخراج أو المسارات.
فيما يلي خطوات العمل مع توقيع المستند:
- تحميل الملف إلى وحدة تخزين.
- قم بإنشاء توقيع.
- تحقق من التوقيع.
- ابحث عن توقيع.
- قم بتنزيل ملف HTML.
1 . تحميل الملف إلى وحدة تخزين
يوضح الكود التالي كيفية تحميل الملفات إلى وحدة تخزين.
### Upload document to default storage
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/storage/file/signaturedocs%2Fone-page.docx?storageName=MyStorage"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
الآن ملفنا “one-page.docx” متاح ضمن مجلد “Signaturedocs” على التخزين.
2 . إنشاء توقيع الباركود
GroupDocs.Signature Cloud REST API تدعم توقيع مستند باستخدام الرمز الشريطي. يوفر طرقًا لإنشاء توقيع الباركود في صفحات المستند بخيارات مختلفة لنوع الباركود والموقع والمحاذاة والخط والهوامش والمظاهر باستخدام بيانات كائنات خيار التوقيع في نص الطلب.
يوضح الكود التالي كيفية إنشاء توقيع الباركود.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/create"
-H "accept: application/json" -H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": { \"FilePath\": \"one-page.docx\", \"StorageName\": \"MyStorage\", \"VersionId\": \"\",
\"Password\": \"\" }, \"SaveOptions\": { \"OverwriteExisting\": true, \"OutputFilePath\": \"result-one-page.docx\", \"SaveFormat\": \"docx\" },
\"SignOptions\": [ { \"DocumentType\": \"WordProcessing\", \"SignatureType\": \"Barcode\", \"Page\": 1, \"AllPages\": false,
\"PagesSetup\": { \"FirstPage\": false, \"LastPage\": true, \"OddPages\": false, \"EvenPages\": true, \"PageNumbers\": [1] },
\"Text\": \"John Smith\", \"BarcodeType\": \"Code128\", \"Left\": 2, \"Top\": 2, \"Width\": 200, \"Height\": 100, \"Stretch\": \"None\",
\"RotationAngle\": 45, \"HorizontalAlignment\": \"Left\", \"VerticalAlignment\": \"Center\", \"LocationMeasureType\": \"Pixels\", \"SizeMeasureType\": \"Pixels\",
\"Margin\": { \"All\": 5, \"Left\": 5, \"Top\": 5, \"Right\": 5, \"Bottom\": 5 }, \"MarginMeasureType\": \"Pixels\",
\"Font\": { \"FontFamily\": \"Times New Roman\", \"FontSize\": 14.0, \"Bold\": false, \"Italic\": false, \"Underline\": false },
\"ForeColor\": { \"Web\": \"DarkOrange\" }, \"BorderColor\": { \"Web\": \"DarkOrange\", \"Alpha\": \"20\", },
\"BackgroundBrush\": { \"Color\": {\"Web\": \"DarkBlue\"}, \"BrushType\": \"SolidBrush\" },
\"BorderVisiblity\": true, \"BorderDashStyle\": \"Dash\", \"BorderTransparency\": 0.55, \"BorderWeight\": 12.0, \"BackgroundTransparency\": 0.8,
\"TextHorizontalAlignment\": \"Left\", \"TextVerticalAlignment\": \"Top\", \"Opacity\": 0.5, \"CodeTextAlignment\": \"Below\",
\"InnerMargins\": { \"All\": 5, \"Left\": 5, \"Top\": 5, \"Right\": 5, \"Bottom\": 5 },} ]}"
3 . تحقق من التوقيع
GroupDocs.Signature Cloud REST API توفر طرقًا للتحقق من توقيع الباركود في صفحات المستندات بخيارات مختلفة لرقم الصفحة والنص ومعايير البحث باستخدام كائنات خيارات التحقق في نص الطلب.
يوضح الكود التالي كيفية التحقق من توقيع الرمز الشريطي.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/verify"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{\"FileInfo\": {\"FilePath\": \"signed/Signed_BarCode.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\",},\"VerifyOptions\": [{\"DocumentType\": \"Pdf\",
\"SignatureType\": \"Text\",\"Page\": 1,\"Text\": \"John\",\"MatchType\": \"Contains\"}] }}} ]}"
4 . ابحث عن توقيع
GroupDocs.Signature Cloud API يوفر طريقة للبحث في توقيع الباركود في صفحات المستندات بخيارات مختلفة من نوع الرمز الشريطي والاسم والنص ونوع المطابقة وميزات البحث الأخرى باستخدام بيانات كائن خيارات البحث في نص الطلب.
يوضح الكود التالي كيفية البحث في توقيع الرمز الشريطي.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/search"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": {\"FilePath\": \"signaturedocs/one-page.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\" }, \"SearchOptions\": [ {\"DocumentType\": \"Pdf\",\"SignatureType\": \"Barcode\",
\"Page\": 1,\"Text\": \"123\",\"BarcodeType\": \"Code128\",\"MatchType\": \"Contains\"}] }"
5 . تحميل الملف
يوضح الكود التالي كيفية تنزيل ملف معين.
### Download document from default storage
curl -X GET "https://api.groupdocs.cloud/v2.0/signature/storage/file/one-page.docx?storageName=MyStorage"
-H "accept: multipart/form-data"
-H "authorization: Bearer [Access Token]"
هذا كل شيء.
ابدأ تجربة مجانية اليوم
ابدأ إصدارًا تجريبيًا مجانيًا اليوم - كل ما تحتاجه هو الاشتراك في خدمة GroupDocs Cloud. بمجرد التسجيل ، ستكون جاهزًا لتجربة ميزات معالجة الملفات القوية التي تقدمها GroupDocs Cloud.