يا رفاق ، لقد ولت مهمة الأيام الخوالي المملة المتمثلة في توقيع المستند ، عندما اعتدت طباعة المستندات والتوقيع عليها ومسحها ضوئيًا ونشرها. الآن في هذا العصر الرقمي ، جعلت خيارات توقيع المستندات عبر الإنترنت الحياة أسهل. و GroupDocs.Signature Cloud REST API تم اختبارها وموثوقة بواجهة برمجة تطبيقات REST للتوقيع الإلكتروني لإضافة قوة التوقيعات الإلكترونية في تطبيقاتك دون تثبيت أي برنامج تابع لجهة خارجية. يساعدك على تأمين مستنداتك إلكترونيًا عن طريق تطبيق Text و Stamp و QR-Code و Barcode و Image و Digital Signatures. تم إصدار إصدار جديد من GroupDocs.Signature Cloud 19.5.
يرجى مراجعة ملاحظات الإصدار التفصيلية لهذا الإصدار للحصول على فكرة حول جميع الميزات / التحسينات الجديدة التي تم إجراؤها في هذا الإصدار.
ما هو الجديد
إصدار API - تم تقديم إصدار API V2
المصادقة - مصادقة JWT (JSON Web Token)
Signature API - طرق API مبسطة لإنشاء التوقيعات والتحقق منها والبحث عنها ، مثل الحصول على معلومات إضافية من المستندات
File API - طرق مقدمة لتحميل الملفات وتنزيلها ونسخها ونقلها وحذفها: مستندات الإدخال وعرض النتائج ، في التخزين السحابي
واجهة برمجة تطبيقات المجلد - طرق مقدمة لإنشاء المجلدات ونسخها ونقلها وحذفها في التخزين السحابي
واجهة برمجة تطبيقات التخزين - طرق مقدمة للحصول على معلومات التخزين ومعلومات الملف
كيف تعمل
التغيير الرئيسي في هذا الإصدار هو إدخال إصدار V2 API ، وهو إصدار API جديد بالكامل. إنها واجهة برمجة تطبيقات أكثر بساطة بأساليب وخيارات أقل. أيضًا ، لديها بنية داخلية محسّنة وصقلها. في هذا الإصدار ، تتضمن واجهة برمجة التطبيقات طرقًا للعمل مع التخزين السحابي. لذا يمكنك تنفيذ عمليات التخزين باستخدام GroupDocs.Signature Cloud REST API بدلاً من استخدام واجهة برمجة تطبيقات منفصلة.
هنا سنوضح لك كيف يعمل إصدار GroupDocs.Signature Cloud V2 API وهو مختلف عن V1. سنضيف توقيع الباركود في مستند Word باستخدام V1 و V2 باتباع الخطوات التالية:
- استرجاع رمز الوصول
- تحميل وثيقة المصدر إلى التخزين
- أضف توقيع الرمز الشريطي إلى المستند المصدر
يمكنك أن تلاحظ من أمثلة cURL التالية أننا استخدمنا مصادقة JWT في مثال V2. يرجى ملاحظة أن OAuth 2.0 و URL توقيع طلب طرق المصادقة لإصدار V1 API لم تعد مدعومة في V2 بعد الآن. الآن ، يدعم إصدار V2 API مصادقة JWT (JSON Web Token).
في طريقة الإصدار الجديد ، استخدمنا طريقة ملف لواجهة برمجة تطبيقات V2 لتحميل الملف على التخزين بدلاً من طريقة GroupDocs.Storage Cloud. والاختلاف الأخير عن الأمثلة التالية ، ولكن ليس آخراً ، في V2 ، يتم استخدام إنشاء واجهة برمجة تطبيقات واحدة لجميع أنواع التوقيع المدعومة عن طريق تمرير تفاصيل التوقيع كمعامل. ومع ذلك ، في V1 ، اعتدنا على استدعاء واجهات برمجة تطبيقات مختلفة لكل نوع توقيع.
مثال V1.1
### Retrieve access token
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl "https://api.groupdocs.cloud/oauth2/token"
-X POST
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"
-H "Content-Type: application/x-www-form-urlencoded"
-H "Accept: application/json"
### Upload file to Aspose Cloud Storage
curl "https://api.aspose.cloud/v1.1/storage/file?path=one-page.docx"
-X PUT
-T C:/Temp/one-page.docx
-H "Content-Type: multipart/form-data"
-H "Accept: application/json"
-H "Authorization: Bearer [ACCESS_TOKEN]"
### Add Barcode Signature to Document
curl "https://api.groupdocs.cloud/v1/signature/one-page.docx/barcode"
-X POST
-H "accept: application/json"
-H "Content-Type: application/json"
-H "authorization: Bearer [ACCESS_TOKEN]"
-d "{"BarcodeTypeName": "Code128","BorderVisiblity" : true,"BorderDashStyle" : "DashDotDot","BorderWeight" : 1,"Opacity" : 0.5,"Margin": {"All": 0,"Left": 0,"Top": 0,"Right": 0,"Bottom": 0},"SheetNumber": 1,"RowNumber": 11,"ColumnNumber": 22,"BorderVisiblity": true,"BorderDashStyle": 5,"BorderTransparency": 0.0,"BorderWeight": 1.0,"BackgroundTransparency": 0.1,"SignatureImplementation": "TextStamp","Text": "John Smith","Width": 100,"Height": 100,"LocationMeasureType": "Pixels","SizeMeasureType": "Pixels","RotationAngle": 0,"HorizontalAlignment": "Right","VerticalAlignment": "Center","MarginMeasureType": "Pixels","SignAllPages": false,"Font": {"FontFamily": "Times New Roman","FontSize": 14.0,"Bold": false,"Italic": false,"Underline": false},"ForeColor": {"Web": "Black"},"BorderColor": {"Web": "Black"},"BackgroundColor": {"Web": "OrangeRed"},"OptionsType": "WordsSignBarcodeOptionsData"}"
مثال V2.0
### Retrieve access token JWT(JSON Web Token)
### TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
curl -v "https://api.groupdocs.cloud/connect/token"
-X POST
-H "Content-Type: application/x-www-form-urlencoded"
-D "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]"
### Upload file into the storage
curl --request POST "https://api.groupdocs.cloud/v2/signature/storage/file/one-page.docx"
--header "authorization: Bearer [ACCESS_TOKEN]"
--data-binary @"c:\temp\one-page.docx"
### Add Barcode Signature to Document
curl "https://api.groupdocs.cloud/v2.0/signature/create"
-X POST
-H "accept: application/json"
-H "authorization: Bearer [ACCESS_TOKEN(JWT)]"
-H "Content-Type: application/json"
-d "{"FileInfo": { "FilePath": "one-page.docx", "StorageName": "", "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 },} ]}"
تقديم التغذية الراجعة
لا تتردد في ترك تعليق لنا أدناه لمشاركة أفكارك حول الإصدار الجديد من GroupDocs.Signature Cloud 19.5. أو قم بزيارة منتدى الدعم وأخبرنا إذا كان لديك أي اقتراحات أو إذا كنت بحاجة إلى أي ميزات / تحسينات معينة تتوقعها من واجهة برمجة التطبيقات الخاصة بنا.
وإذا لم تكن لديك بالفعل فرصة لتجربة واجهة برمجة تطبيقات REST الخاصة بنا ، فما عليك سوى بدء إصدار تجريبي مجاني اليوم. كل ما تحتاجه هو الاشتراك في groupdocs.cloud. بمجرد التسجيل ، ستكون جاهزًا لتجربة ميزات معالجة الملفات القوية التي تقدمها groupdocs.cloud.