امروز، GroupDocs اولین نسخه عمومی نسل بعدی GroupDocs.Signature Cloud 17.12 را اعلام کرد. این یک E-Signature REST API برای اضافه کردن قدرت امضای الکترونیکی در برنامه های شما بدون نصب نرم افزار اضافی است. GroupDocs.Signature Cloud API یک راه آسان برای دادن قابلیت امضای الکترونیکی به برنامه‌های شما با ویژگی‌هایی مانند افزودن امضای الکترونیکی، [تأیید امضا2 و جستجو است. امضا در فرمت های فایل پشتیبانی شده همراه با ویژگی های دیگر. لطفاً Release Notes را برای فهرست کامل ویژگی‌های ارائه شده در اولین نسخه GroupDocs.Signature Cloud بررسی کنید. بخش های زیر برخی از جزئیات در مورد این ویژگی ها را شرح می دهد.

انواع امضای پشتیبانی شده

اولین نسخه از GroupDocs.Signature Cloud از انواع زیر از امضاها در API پشتیبانی می کند:

  • امضای دیجیتالی
  • امضای بارکد
  • امضای کد QR
  • امضای متن
  • امضای تصویر

اضافه کردن امضای دیجیتال به سند

GroupDocs.Signature Cloud REST API از افزودن امضای دیجیتال به یک سند پشتیبانی می کند. روش هایی برای ایجاد امضای دیجیتال در صفحات سند با گزینه های مختلف از نوع گواهی، مکان، تراز، فونت، حاشیه و ظاهر با استفاده از داده های Signature Options Objects در بدنه درخواست ارائه می دهد. لطفاً URI، دستور REST (Curl) و .NET SDK زیر را برای این منظور ببینید. URI

https://api.groupdocs.cloud/v1/signature/{filename}/digital

درخواست داده

{"Visible": true,"Password": "password","CertificateGuid": "temp.pfx","ImageGuid": "signature.jpg","Left": 10,"Top": 10,"Width": 40,"Height": 10,"LocationMeasureType": "Millimeters","SizeMeasureType": "Millimeters","RotationAngle": 0,"HorizontalAlignment": "Right","VerticalAlignment": "Bottom","Margin": {"All": 10,"Left": 10,"Top": 10,"Right": 10,"Bottom": 10},"MarginMeasureType": "Millimeters","Opacity": 0.5,"SignAllPages": true,"DocumentPageNumber": 1,"OptionsType": "PdfSignDigitalOptionsData"}

نمونه بقیه (cURL)

curl -v "https://api.groupdocs.cloud/v1/signature/01_pages.pdf/digital" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d "{"Visible": true,"Password": "password","CertificateGuid": "temp.pfx","ImageGuid": "signature.jpg","Left": 10,"Top": 10,"Width": 40,"Height": 10,"LocationMeasureType": "Millimeters","SizeMeasureType": "Millimeters","RotationAngle": 0,"HorizontalAlignment": "Right","VerticalAlignment": "Bottom","Margin": {"All": 10,"Left": 10,"Top": 10,"Right": 10,"Bottom": 10},"MarginMeasureType": "Millimeters","Opacity": 0.5,"SignAllPages": true,"DocumentPageNumber": 1,"OptionsType": "PdfSignDigitalOptionsData"}" \
-H "authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”

مثال NET SDK

//TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
var configuration = new Configuration
{
    AppSid = Sid,
    AppKey = Key
};

var apiInstance = new SignatureApi(configuration);

try
{
    var signOptionsData = new GroupDocs.Signature.Cloud.Sdk.Model.PdfSignDigitalOptionsData()
    {
        DocumentPageNumber = 1,
        Height = 80,
        HorizontalAlignment = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.HorizontalAlignmentEnum.Right,
        Left = 10,
        LocationMeasureType = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.LocationMeasureTypeEnum.Pixels,
        Margin = new GroupDocs.Signature.Cloud.Sdk.Model.PaddingData() { Left = 10, Right = 10, Bottom = 10, Top = 10 },
        MarginMeasureType = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.MarginMeasureTypeEnum.Pixels,
        Opacity = 0.5,
        SignAllPages = false,
        CertificateGuid = "temp.pfx",
        Password="password",
        ImageGuid="signature.jpg",
        Top = 100,
        VerticalAlignment = GroupDocs.Signature.Cloud.Sdk.Model.SignDigitalOptionsData.VerticalAlignmentEnum.Center,
        Width = 100
    };
    var request = new PostDigitalRequest
    {
        Name = "02_pages.pdf",
        SignOptionsData = signOptionsData,
        Password = null,
        Folder = null,

    };

    var response = apiInstance.PostDigital(request);

    Debug.Print("FleName: " + response.FileName);

}
catch (Exception e)
{
    Debug.Print("Exception when signing document with digital signature: " + e.Message);
}

تأیید امضای دیجیتال

GroupDocs.Signature Cloud REST API از تأیید یک سند امضا شده پشتیبانی می کند. روش هایی برای تأیید امضای دیجیتال در صفحات اسناد با گزینه های مختلف برای شماره صفحه، متن و معیارهای جستجو با استفاده از داده های Verification Options Objects در بدنه درخواست ارائه می دهد. لطفاً URI، داده‌های درخواست JSON، دستور REST (Curl) و NET SDK را برای این منظور ببینید. URI

https://api-qa.groupdocs.cloud/v1/signature/{filename}/digital/verification?Folder={folder}

درخواست داده

"{"DocumentPageNumber":1,"Password": "password","CertificateGuid": "temp.pfx","Comments": "verified data","SignDateTimeFrom": "1/12/2017","SignDateTimeTo":"12/12/2017","OptionsType":"PdfVerifyDigitalOptionsData"}

نمونه بقیه (cURL)

curl -v "[https://api-qa.groupdocs.cloud/v1/signature/Signed_Digital.pdf/digital/verification?Folder=signed"][7] \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d "{"DocumentPageNumber":1,"Password": "password","CertificateGuid": "temp.pfx","Comments": "verified data","SignDateTimeFrom": "1/12/2017","SignDateTimeTo":"12/12/2017","OptionsType":"PdfVerifyDigitalOptionsData"}" \
-H "authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”

مثال NET SDK

//TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
var configuration = new Configuration
{
    AppSid = Sid,
    AppKey = Key
};
var apiInstance = new SignatureApi(configuration);
try
{
    var verifyOptionsData = new GroupDocs.Signature.Cloud.Sdk.Model.PdfVerifyDigitalOptionsData()
    {
        DocumentPageNumber= 1,
        Password = "password",
        CertificateGuid = "temp.pfx",
    };
    var request = new PostVerificationDigitalRequest
    {
        Name = "Signed_Digital.pdf",
        VerifyOptionsData = verifyOptionsData,
        Password = null,
        Folder = "signed"
    };
var response = apiInstance.PostVerificationDigital(request);
Debug.Print("FleName: " + response.FileName);
Debug.Print("Result: " + response.Result);
}
catch (Exception e)
{
Debug.Print("Exception when verifying Digital signature: " + e.Message);
}

API Explorer

APIهای GroupDocs برای Cloud REST دارای یک API Explorer مبتنی بر وب هستند، که ساده‌ترین راه را برای امتحان کردن API ما فوراً در مرورگر مورد علاقه‌تان ارائه می‌کند. این مجموعه ای از اسناد Swagger برای GroupDocs برای API های ابری است. بنابراین، ابتدا باید با GroupDocs برای Cloud ثبت نام کنید، کلید APP و SID را دریافت کنید و آزمایش GropuDocs.Signature Cloud Rest API را در مرورگر وب به صورت تعاملی شروع کنید.

GroupDocs.Signature منابع ابری

در زیر پیوندهایی به برخی از منابع مفیدی که ممکن است برای انجام وظایف خود به آن نیاز داشته باشید آورده شده است.

امروز یک آزمایش رایگان را شروع کنید

امروز یک دوره آزمایشی رایگان را شروع کنید – تنها چیزی که نیاز دارید این است که با سرویس GroupDocs Cloud ثبت نام کنید. پس از ثبت نام، آماده هستید تا ویژگی های پردازش فایل قدرتمند ارائه شده توسط GroupDocs Cloud را امتحان کنید.