Что такое электронная подпись?
Электронная подпись или электронная подпись относится к данным в электронной форме, которые логически связаны с другими данными в электронной форме и которые используются подписывающим лицом для подписи. Этот тип подписи имеет такой же юридический статус, что и собственноручная подпись, если он соответствует требованиям конкретного нормативного акта. Электронные подписи могут быть в виде цифрового текста, изображений, штрих-кода, QR-кода и т. д.
Электронные подписи — это юридическое понятие, отличное от цифровых подписей, криптографического механизма, часто используемого для реализации электронных подписей. В то время как электронная подпись может быть такой же простой, как имя, введенное в электронный документ, цифровые подписи все чаще используются в электронной коммерции и в нормативных документах для реализации электронных подписей криптографически защищенным способом.
Облачный API GroupDocs.Signature?
GroupDocs.Signature Cloud — это REST API для создания, проверки и поиска различных типов объектов подписи в документах в облаке. Существует пять основных типов поддерживаемых подписей, с которыми вы можете работать:
- Текстовая подпись
- Подпись штрих-кода
- Подпись QR-кода
- Цифровая подпись
- Подпись изображения
- Печать Подпись
Как работать с документом со штрих-кодом, используя API электронной подписи?
Этот API предназначен для добавления электронных подписей к документам на основе параметров, передаваемых в виде массива параметров подписи. Визуализированный документ можно загрузить, используя выходные URL-адреса или пути.
Вот шаги для работы с подписью документа:
- Загрузить файл в хранилище.
- Создать подпись.
- Подтвердить подпись.
- Найдите подпись.
- Скачать HTML-файл.
1. Загрузить файл в хранилище
Следующий код демонстрирует, как загружать файлы в хранилище.
### Upload document to default storage
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/storage/file/signaturedocs%2Fone-page.docx?storageName=MyStorage"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
Теперь наш файл “one-page.docx” доступен в папке “signaturedocs” на складе.
2. Создание подписи штрих-кода
GroupDocs.Signature Cloud REST API поддерживает подпись документа с помощью штрих-кода. Он предоставляет методы для создания подписи штрих-кода на страницах документа с различными параметрами типа штрих-кода, местоположения, выравнивания, шрифта, полей и внешнего вида с использованием данных Объекты параметров подписи в теле запроса.
Следующий код демонстрирует, как создать подпись штрих-кода.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/create"
-H "accept: application/json" -H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": { \"FilePath\": \"one-page.docx\", \"StorageName\": \"MyStorage\", \"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 },} ]}"
3. Подтвердить подпись
GroupDocs.Signature Cloud REST API предоставляет методы проверки подписи штрих-кода на страницах документов с различными вариантами номера страницы, текста и критериев поиска с использованием данных Verification Options Objects в теле запроса.
Следующий код демонстрирует, как проверить подпись штрих-кода.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/verify"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{\"FileInfo\": {\"FilePath\": \"signed/Signed_BarCode.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\",},\"VerifyOptions\": [{\"DocumentType\": \"Pdf\",
\"SignatureType\": \"Text\",\"Page\": 1,\"Text\": \"John\",\"MatchType\": \"Contains\"}] }}} ]}"
4. Поиск подписи
GroupDocs.Signature Cloud API предоставляет метод поиска подписи штрих-кода на страницах документа с различными параметрами типа штрих-кода, имени, текста, типа соответствия и другими функциями поиска с использованием данных Search Options Object в тексте запроса.
Следующий код демонстрирует, как искать подпись штрих-кода.
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/search"
-H "accept: application/json"
-H "authorization: Bearer [Access Token]"
-H "Content-Type: application/json" -d "{ \"FileInfo\": {\"FilePath\": \"signaturedocs/one-page.pdf\",\"StorageName\": \"MyStorage\",
\"VersionId\": \"\", \"Password\": \"\" }, \"SearchOptions\": [ {\"DocumentType\": \"Pdf\",\"SignatureType\": \"Barcode\",
\"Page\": 1,\"Text\": \"123\",\"BarcodeType\": \"Code128\",\"MatchType\": \"Contains\"}] }"
5. Загрузить файл
Следующий код демонстрирует, как загрузить определенный файл.
### Download document from default storage
curl -X GET "https://api.groupdocs.cloud/v2.0/signature/storage/file/one-page.docx?storageName=MyStorage"
-H "accept: multipart/form-data"
-H "authorization: Bearer [Access Token]"
Вот и все.
Начните бесплатную пробную версию сегодня
Начните бесплатную пробную версию сегодня — все, что вам нужно, это зарегистрироваться в облачной службе GroupDocs. После регистрации вы готовы попробовать мощные функции обработки файлов, предлагаемые GroupDocs Cloud.