بچه ها، کار خسته کننده قدیم برای امضای یک سند از بین رفته است، زمانی که اسناد را چاپ، امضا، اسکن و پست می کردید. اکنون در این عصر دیجیتال، گزینه‌های امضای آنلاین سند زندگی را آسان‌تر کرده است. و GroupDocs.Signature Cloud REST API تست شده و قابل اعتماد e-Signature REST API برای اضافه کردن قدرت امضای الکترونیکی در برنامه های شما بدون نصب نرم افزار شخص ثالث است. این به شما کمک می کند تا با استفاده از متن، مهر، کد QR، بارکد، تصویر و امضاهای دیجیتال به صورت الکترونیکی اسناد خود را ایمن کنید. نسخه جدید GroupDocs.Signature Cloud 19.5 منتشر شد.

لطفاً [یادداشت‌های انتشار1 این نسخه را بررسی کنید تا در مورد همه ویژگی‌ها/بهبودهای جدید ساخته شده در این نسخه ایده بگیرید.

چه خبر

نسخه API - نسخه V2 API معرفی شد

احراز هویت - احراز هویت JWT (JSON Web Token).

Signature API - روش های API ساده شده برای ایجاد، تأیید و جستجوی امضاها، مانند دریافت اطلاعات اضافی اسناد

File API – روش‌های معرفی شده برای آپلود، دانلود، کپی، انتقال، حذف فایل‌ها: اسناد ورودی و نتایج رندر، در فضای ذخیره‌سازی ابری

Folder API - روش هایی برای ایجاد، کپی، انتقال، حذف پوشه ها در فضای ذخیره سازی ابری معرفی شده است

Storage API - روش هایی برای دریافت اطلاعات ذخیره سازی و اطلاعات فایل معرفی شده است

چگونه کار می کند

تغییر عمده در این نسخه، معرفی نسخه V2 API است، همه نسخه API جدید است. این API ساده تر با روش ها و گزینه های کمتر است. همچنین، دارای معماری داخلی بهینه و اصلاح شده تری است. در این نسخه، API شامل روش هایی برای کار با فضای ذخیره سازی ابری است. بنابراین می توانید به جای استفاده از API جداگانه، عملیات ذخیره سازی را با استفاده از GroupDocs.Signature Cloud REST API انجام دهید.

در اینجا ما به شما نشان خواهیم داد که چگونه نسخه GroupDocs.Signature Cloud V2 API کار می کند و با V1 متفاوت است. با دنبال کردن این مراحل، امضای بارکد را با استفاده از V1 و V2 در یک سند Word اضافه می کنیم:

• رمز دسترسی را بازیابی کنید
• سند منبع را در فضای ذخیره‌سازی بارگذاری کنید
• امضای بارکد را به سند منبع اضافه کنید

می توانید از نمونه های زیر cURL متوجه شوید که ما از احراز هویت JWT در مثال V2 استفاده کرده ایم. لطفاً توجه داشته باشید که روش‌های تأیید اعتبار درخواست OAuth 2.0 و امضای URL نسخه V1 API دیگر در V2 پشتیبانی نمی‌شوند. اکنون نسخه V2 API از احراز هویت JWT (JSON Web Token) پشتیبانی می کند.

در روش انتشار جدید به جای روش GroupDocs.Storage Cloud از روش File از API V2 برای آپلود فایل در فضای ذخیره سازی استفاده کردیم. و آخرین تفاوت با مثال‌های زیر، اما نه کم‌اهمیت، در V2 یک ایجاد API واحد برای همه انواع امضای پشتیبانی شده با ارسال جزئیات امضا به عنوان پارامتر استفاده می‌شود. با این حال، در V1 ما برای هر نوع امضا، API های مختلفی را فراخوانی می کردیم.

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 در زیر با ما در میان بگذارید. یا از Support Forum ما دیدن کنید و اگر پیشنهادی دارید یا اگر به ویژگی/بهبود خاصی نیاز دارید که انتظار دارید API ما داشته باشد، به ما اطلاع دهید.

و اگر قبلاً فرصتی برای امتحان REST API ما نداشته اید، به سادگی یک آزمایش رایگان را امروز شروع کنید. تنها چیزی که نیاز دارید این است که با groupdocs.cloud ثبت نام کنید. پس از ثبت نام، آماده هستید تا ویژگی های پردازش فایل قدرتمند ارائه شده توسط groupdocs.cloud را امتحان کنید.