Ребята, утомительная работа по подписанию документов ушла в прошлое, когда вы печатали, подписывали, сканировали и размещали документы. Теперь, в эту цифровую эпоху, возможности онлайн-подписания документов упростили жизнь. А GroupDocs.Signature Cloud REST API — это проверенный и надежный REST API для электронной подписи, позволяющий добавить возможности электронных подписей в ваши приложения без установки какого-либо стороннего программного обеспечения. Это поможет вам защитить ваши документы в электронном виде, применяя текст, штамп, QR-код, штрих-код, изображение и цифровые подписи. Выпущена новая версия GroupDocs.Signature Cloud 19.5.

Пожалуйста, ознакомьтесь с подробными примечаниями к выпуску этой версии, чтобы получить представление обо всех новых функциях/улучшениях, внесенных в этот выпуск.

Что нового

Версия API — введена версия API V2.

Аутентификация — аутентификация JWT (JSON Web Token)

Signature API — упрощенные методы API для создания, проверки и поиска подписей, а также для получения дополнительной информации о документах.

Файловый API — введены методы загрузки, скачивания, копирования, перемещения, удаления файлов: входные документы и результаты рендеринга в облачном хранилище.

Folder API — Представлены методы создания, копирования, перемещения, удаления папок в облачном хранилище.

Storage API — введены методы для получения информации о хранилище и информации о файлах.

Как это работает

Основным изменением в этом выпуске является введение версии API V2, это все новая версия API. Это более упрощенный API с меньшим количеством методов и опций. Кроме того, он имеет более оптимизированную и доработанную внутреннюю архитектуру. В этой версии API включает методы работы с облачным хранилищем. Таким образом, вы можете выполнять операции хранения с помощью REST API GroupDocs.Signature Cloud вместо использования отдельного API.

Здесь мы покажем вам, как работает версия API GroupDocs.Signature Cloud V2, и она отличается от V1. Мы добавим подпись штрих-кода в документ Word, используя V1 и V2, выполнив следующие действия:

Получить токен доступа
Загрузить исходный документ в хранилище
Добавить подпись штрих-кода в исходный документ

Из следующих примеров cURL вы можете заметить, что мы использовали JWT-аутентификацию в примере V2. Обратите внимание, что методы аутентификации запроса OAuth 2.0 и подписи URL в версии V1 API больше не поддерживаются в версии V2. Теперь версия V2 API поддерживает аутентификацию JWT (JSON Web Token).

В новом методе выпуска мы использовали метод File API V2 для загрузки файла в хранилище вместо метода GroupDocs.Storage Cloud. И последнее отличие от следующих примеров, но не менее важное: в версии 2 для всех поддерживаемых типов подписей используется единый API create с передачей сведений о подписи в качестве параметра. Однако в версии 1 мы использовали разные 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"}"

Пример версии 2.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. Или посетите наш Форум поддержки и дайте нам знать, если у вас есть какие-либо предложения или вам нужны какие-либо определенные функции/улучшения, которые вы ожидаете от нашего API.

И если у вас еще не было возможности попробовать наш REST API, просто запустите бесплатную пробную версию сегодня. Все, что вам нужно, это зарегистрироваться в groupdocs.cloud. После регистрации вы готовы попробовать мощные функции обработки файлов, предлагаемые groupdocs.cloud.

Что нового#

Как это работает#

Обеспечить обратную связь#

Что нового

Как это работает

Обеспечить обратную связь