Сьогодні GroupDocs оголошує про перший публічний випуск Next Generation GroupDocs.Signature Cloud 17.12. Це REST API електронного підпису, який додає можливості електронних підписів у ваші програми без встановлення додаткового програмного забезпечення. GroupDocs.Signature Cloud API — це простий спосіб надати вашим програмам функції електронного підпису за допомогою таких функцій, як додавання електронного підпису, перевірка підпису і пошук підпис у підтримуваних форматах файлів разом з іншими функціями. Перегляньте примітки до випуску, щоб отримати повний список функцій, які пропонуються в першій версії GroupDocs.Signature Cloud. У наступних розділах описано деякі подробиці щодо цих функцій.

Підтримувані типи підписів

Перша версія GroupDocs.Signature Cloud підтримує такі типи підписів в API:

  • Цифровий підпис
  • Підпис штрих-коду
  • Підпис QR-коду
  • Текстовий підпис
  • Підпис зображення

Додати цифровий підпис до документа

GroupDocs.Signature Cloud REST API підтримує додавання цифрового підпису до документа. Він надає методи створення цифрового підпису на сторінках документа з різними параметрами типу сертифіката, розташування, вирівнювання, шрифту, полів і вигляду за допомогою даних об’єктів параметрів підпису в тілі запиту. Перегляньте наведений нижче 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 підтримує перевірку підписаного документа. Він надає методи перевірки цифрового підпису на сторінках документів із різними варіантами номерів сторінок, тексту та критеріїв пошуку за допомогою даних об’єктів параметрів перевірки в тілі запиту. Перегляньте наведений нижче 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

GroupDocs for Cloud REST API постачається з веб-інтерфейсом API Explorer, який забезпечує найпростіший спосіб випробувати наш API одразу у вашому улюбленому браузері. Це збірка документації Swagger для GroupDocs для Cloud API. Отже, спочатку вам потрібно зареєструватися в GroupDocs for Cloud, отримати ключ APP і SID і почати інтерактивне тестування GropuDocs.Signature Cloud Rest API у веб-переглядачі.

Хмарні ресурси GroupDocs.Signature

Нижче наведено посилання на деякі корисні ресурси, які можуть знадобитися для виконання ваших завдань.

Почніть безкоштовну пробну версію сьогодні

Розпочніть безкоштовну пробну версію сьогодні – все, що вам потрібно, це зареєструватися в хмарній службі GroupDocs. Зареєструвавшись, ви готові спробувати потужні функції обробки файлів, які пропонує GroupDocs Cloud.