Сегодня GroupDocs объявляет о первом общедоступном выпуске Next Generation GroupDocs.Signature Cloud 17.12. Это REST API для электронной подписи, позволяющий добавить возможности электронных подписей в ваши приложения без установки какого-либо дополнительного программного обеспечения. Облачный API GroupDocs.Signature — это простой способ предоставить вашим приложениям функцию электронной подписи с такими функциями, как добавление электронной подписи, проверка подписи и поиск подпись в поддерживаемых форматах файлов вместе с другими функциями. Пожалуйста, ознакомьтесь с примечаниями к выпуску для получения полного списка функций, предлагаемых в первой версии 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”

Пример пакета SDK для .NET

//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”

Пример пакета SDK для .NET

//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

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

Облачные ресурсы GroupDocs.Signature

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

Начните бесплатную пробную версию сегодня

Начните бесплатную пробную версию сегодня — все, что вам нужно, это зарегистрироваться в облачной службе GroupDocs. После регистрации вы готовы попробовать мощные функции обработки файлов, предлагаемые GroupDocs Cloud.